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BACKGROUND OF THE INVENTION 



Field of the Invention 

The present invention relates to systems and protocols supporting 
transactions among diverse clients coupled to a network; and more particularly 
to systems and protocols supporting commercial transactions among platforms 
having variant architectures. 

Description of Related Art 

The Internet and other communications networks provide avenues for 
communication among people and computer platforms which are being used for 
a wide variety of transactions, including commercial transactions in which 
participants buy and sell goods and services. Many efforts are underway to 
facilitate commercial transactions on the Internet. However, with many 
competing standards, in order to execute a transaction, the parties to the 
transaction must agree in advance on the protocols to be utilized, and often 
require custom integration of the platform architectures to support such 
transactions. Commercial processes internal to a particular node not compatible 
with agreed upon standards, may require substantial rework for integration with 
other nodes. Furthermore, as a company commits to one standard or the other, 
the company becomes locked-in to a given standardized group of transacting 
parties, to the exclusion of others. 

A good overview of the challenges met by Internet commerce 
development is provided in Tenenbaum, et al, "Eco System: An Internet 
Commerce Architecture", Computer, May 1997, pp. 48-55. 

To open commercial transactions on the Internet, standardization of 
architectural frameworks is desired. Platforms developed to support such 
commercial frameworks include IBM Commerce Point, Microsoft Internet 
Commerce Framework, Netscape ONE (Open Network Environment), Oracle 
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NCA (Network Computing Architecture), and Sun/JAVASoft JECF (JAVA 
Electronic Commerce Framework). 

In addition to these proprietary frameworks, programming techniques, 
such as common distributed object model based on CORBA HOP (Common 
5 Object Request Broker Architecture Internet ORB Protocol), are being pursued. 

Use of the common distributed object model is intended to simplify the 
migration of enterprise systems to systems which can inter-operate at the 
business application level for electronic commerce. However, a consumer or 
business using one framework is unable to execute transactions on a different 

10 framework. This limits the growth of electronic commerce systems. 

Companies implementing one framework will have an application 
programming interface API which is different than the API's supporting other 
frameworks. Thus, it is very difficult for companies to access each others 
business services, without requiring adoption of common business system 

15 interfaces. The development of such business system interfaces at the API level 

requires significant cooperation amongst the parties which is often impractical. 

Accordingly, it is desirable to provide a framework which facilitates 
interaction amongst diverse platforms in a communication network. Such 
system should facilitate spontaneous commerce between trading partners 

20 without custom integration or prior agreement on industry wide standards. 

Further, such systems should encourage incremental path to business 
automation, to eliminate much of the time, cost and risks of traditional systems 
integration. 

Overall, it is desirable to provide an electronic commerce system that 
25 replaces the closed trading partner networks based on proprietary standards with 

open markets. 
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SUMMARY OF THE INVENTION 
The present invention offers an infrastructure for connecting businesses 
with customers, suppliers and trading partners. Under the infrastructure of the 
5 present invention, companies exchange information and services using self- 

defining, machine-readable documents, such as XML (Extensible Markup 
Language) based documents, that can be easily understood amongst the 
partners. Documents which describe the documents to be exchanged, called 
business interface definitions BIDs herein, are posted on the Internet, or 
1 0 otherwise communicated to members of the network. The business interface 

definitions tell potential trading partners the services the company offers and the 
documents to use when communicating with such services. Thus, a typical 
business interface definition allows a customer to place an order by submitting a 
purchase order, compliant with a document definition published in the BID of a 
15 party to receive the purchase order. A supplier is allowed to check availability 

by downloading an inventory status report compliant with a document definition 
published in the BID of a business system managing inventory data. Use of 
predefined, machine-readable business documents provides a more intuitive and 
flexible way to access enterprise applications. 
20 A node in the commerce network establishes an interface for 

transactions according to the present invention that comprises a machine- 
readable specification of an interface, along with a machine-readable data 
structure that includes interpretation information for the machine-readable 
specification of the interface. The machine-readable specification of the 
25 interface includes a definition of an input document and a definition of an 

output document, that are accepted and produced by transaction processes for 
which the node acts as an interface. The definitions of the input and output 
documents comprise respective descriptions of sets of storage units and logical 
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structures for sets of storage units, such as according to a standard XML based 
document. The machine-readable data structure that includes interpretation 
information according to various aspects of the invention includes data type 
specifications (e.g. string, array, etc.) for logical structures in the definitions of 
5 the input and output documents, content models (e.g. lists of possible values) 

for logical structures and/or data structures that map predefined sets of storage 
units for a particular logic structure to respective entries in a list in order to 
provide a semantic definition of logical structures (e.g. mapping codes to 
product names). 

10 According to other aspects of the invention, the interface includes a 

repository in memory accessible by at least one node in the network that stores a 
library of logic structures and interpretation information for the logic structures. 
The repository can be extended to include a library of definitions of input and 
output documents, a library of specifications of interfaces, and a library of 

15 specifications for participant interface nodes in the network. 

Thus, a participant in the transaction framework of the present invention 
executes transactions amongst nodes in a network that includes a plurality of 
nodes executing processes involved in the transactions. The method includes 
storing a machine-readable specification of an interface for a transaction, the 

20 specification includes a definition of an input document and a definition of an 

output document. The definition of the input and output documents comprise 
respective descriptions of sets of storage units and logical structures for the sets 
of storage units. In a preferred system, the definitions are expressed in a manner 
compliant with a standard XML document type definition DTD, extended by 

25 semantic mapping, content modeling and data typing of some elements. The 

participant in the transaction receives data comprising a document through a 
communication network. The participant parses the document according to the 
specification stored for a transaction to identify an input document for the 
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transaction. After parsing the document, at least a portion of the input document 
is provided in a machine-readable format to a transaction process which 
produces an output. An output document is formed comprising the output of the 
transaction process, based on the definition of an output document in the stored 
specification. The output document is transmitted on the communication 
network, typically back to the source of the input document, or elsewhere as 
suits the needs of a particular type of transaction. 

Thus the business interface definition bridges the gap between the 
documents specified for example according to XML and the programs which 
execute on the front end of the transaction processing services at particular 
nodes. Such front ends are implemented for example by JAVA virtual 
machines, or by other common architectures providing for interconnection of 
systems across a network. The business interface definition provides a 
technique by which a transaction protocol is programmed using the business 
interface definition document. The program for the protocol of the transaction 
is established by a detailed formal specification of a document type. 

The machine-readable specification of the interface of the transaction is 
made accessible to other platforms in the network. Participant platforms 
include resources to design input documents and output documents according to 
the transaction interface specified at a complementary node. Thus, participant 
nodes include resources to access the definition of an input document for the 
complementary interface and a definition of an output document for the 
complementary interface. The stored specification for the accessing participant 
node is established by including at least part of the definition of the output 
document of the complementary interface in the definition of the input 
document of the interface stored in the specification. 

The process of establishing the stored specification of an interface 
according to another aspect of the invention includes accessing elements of the 
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machine-readable specification from a repository. The repository stores a 
library of logic structures, content models, and schematic maps for logic 
structures, and definition of documents that comprise logic structures used to 
build interface description. A repository accessible in the network facilitates the 
5 building of interface descriptions which can be easily shared. Any differences 

between the input document created for a particular process and the output 
document expected as a return by a complementary process can be easily 
negotiated by communication on the network and agreeing on common logic 
structures to express particular information. 

1 0 The machine-readable specification of an interface of a transaction 

according to one aspect of the invention includes a document compliant with a 
definition of an interface document that is shared amongst members of the 
network. A definition of the interface document includes logic structures for 
storing an identifier of a particular transaction and at least one of definitions and 

1 5 references to definitions of input and output documents for the particular 

transaction. That is, the interface description for a particular service may 
actually encompass a definition of the input and output documents. 
Alternatively, it may include pointers to a location in the repository, or 
elsewhere in the network, of such definitions. 

20 According to another alternative of the invention, the machine-readable 

specification includes a business interface definition BED document compliant 
with a definition of an interface document that includes logical structures for 
storing an identifier of the interface, and for storing at least one of specifications 
and references to specifications of a set of one or more transactions supported 

25 by the interface. For each supported transaction, the document includes at least 

one of definitions and references to definitions of input and output documents 
for the particular transaction. 
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According to another aspect of the invention, the storage units defined in 
the definitions of the input and output document comprise parsed data including 
character data encoding text characters, and mark-up data identifying sets of 
storage units according to the logical structures of the input and output 
5 documents. According to another aspect of the invention, at least one of the sets 

of storage units encodes the plurality of text characters providing a natural 
language word. This facilitates the use of the definitions of input and output 
documents by human readers and developers of such documents. 

According to another aspect of the invention, the specification of the 

1 0 input and output documents includes interpretation information for at least one 

of the sets of storage units identified by the logical structure. The interpretation 
information in one example encodes definitions for sets of parsed characters. In 
another example, the interpretation information provides for content model 
specifications, such as requiring a specific logic structure to carry a member of a 

15 list of codes mapped to product descriptions in a catalog. In some systems, the 

storage units in a logic structure of a document may include sets of unparsed 
data, as suits the needs of a particular implementation. 

According to yet another aspect of the invention, the transaction process 
in a particular platform has a transaction processing architecture which is one of 

20 a plurality of variant transaction processing architectures. Thus the participant 

node includes resources for translating at least a portion of the input document 
into a format readable according to the variant transaction processing 
architecture of the transaction process utilizing the information. The elements 
of the document definition are translated into programming objects that include 

25 variables and methods according to the variant transaction processing 

architectures of the transaction process. For a participant having a JAVA virtual 
machine acting as a transaction process front end, particular fields in the 
documents are translated into JAVA objects, including the data as well as get 
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and set functions associated with a JAVA object. Other transaction processing 
architectures supportable according to the present invention include processes 
compliant with an interface description language in the sense of Common 
Object Request Broker Architecture CORBA, Component Object Model 
5 COM,On-Line Transaction Processing OLTP, and Electronic Data Interchange 

EDI. 

According to other aspects of the invention, a repository is provided that 
stores document types for use in the plurality of transactions. The machine- 
readable specification for a particular transaction defines at least one of the 

1 0 input and output documents by reference to a document type in the repository. 

According to another aspect, the document type included in the repository 
include a document type for identifying participants in the network. Such 
document type providing structures for identifying a participant, specifying the 
services supported by the participant, and specifying the input and output 

15 documents for each of such services. 

In addition to the methods described above, the present invention 
provides an apparatus for managing transactions among nodes that includes a 
network interface, memory for storing data and programs of instructions 
including a machine-readable specification of an interface for a transaction as 

20 described above, and a data processor that is coupled with the memory and the 

network interface. The programs of instructions stored in the apparatus include 
logic to execute the processes described above for a participant in the 
transactions. 

The present invention further provides an apparatus for establishing 
25 participant interfaces for transactions executed on a system that include a 

network interface and a data processing resources that execute transaction 
processes according to a transaction processing architecture. The apparatus 
includes programs of instructions that are executable by the system and stored 
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on a medium accessible by the system that provide tools to build a definition of 
a participant interface for a participant in a particular transaction. The definition 
of a participant interface includes a definition of an input document and a 
definition of an output document. The definitions of the input and output 
documents comprise respective machine-readable descriptions of sets of storage 
units in logical structures for the sets of storage units, which may be compliant 
in one aspect of the invention with XML document type definitions. 

The apparatus for establishing participant interfaces according to this 
aspect of the invention also includes programs of instructions stored on a 
medium accessible by the data processing system and responsive to the 
definitions of input and output documents to compile data structures 
corresponding to the sets of storage units and logical structures of the input and 
output documents that are compliant with the transaction processing 
architecture, to compile instructions executable by the system to translate the 
input document to the corresponding data structures, and to compile instructions 
executable by the system to translate output of the transaction processes into 
sets of storage units and logical structures of the output document. 

The tools to build a definition of a participant interface in a preferred 
system include instructions executable by the system to access elements of the 
definition from complementary nodes and/or from a repository that stores a 
library of logical structures and interpretation information for logical structures 
used to build interface descriptions. According to various aspects of the 
invention, the repository includes not only a library of logical structures but 
definitions of documents that comprise logical structures, and formats for 
specifying participant interfaces. According to this aspect of the invention, 
tools are provided for building specifications of business interfaces according to 
the techniques described above in connection with the description of the 
participant nodes. The tools for building interfaces and the tools for compiling 



Atty Docket No.: 19957-701 

H:\PRIVATE\CLIENT\19957CN0WEOAPP.001 



- 10- 



the interfaces into resources needed for communication with transaction 
processing architectures according to this aspect of the invention, are 
implemented in participant nodes in the preferred system, and utilized for the 
development and optimization of the interface descriptions as use of the 
5 network grows based on interface descriptions that define input and output 

documents. 

Accordingly, another aspect of the invention provides an apparatus that 
includes memory and a data processor that executes instructions stored in the 
memory that include tools to build a definition of a participant interface and a 

10 compiler performing the functions described above. 

According to yet another aspect of the invention, the use of the 
participant interface descriptions enables the operation of a market maker node. 
At such a node, a method for managing transactions is provided that comprises 
storing machine-readable specifications of a plurality of participant interfaces 

1 5 which identify transactions supported by the interfaces, and the respective input 

and output documents of such transactions. As described above, the definitions 
of the input and output documents comprise respective descriptions of sets of 
storage units and logical structures for the sets of storage units, such as 
according to the XML standard. In addition, the definitions of the transactions 

20 and the definitions of the participant interfaces all comprise documents 

specified according to a technique compliant with XML or other standardized 
document expression language. At such market maker node, data comprising a 
document is received over a communication network. The document is parsed 
according to the specifications to identify an input document in one or more 

25 transactions which accept the identified input document. At least a portion of 

the input document is provided in a machine-readable format to a transaction 
process associated with the one or more identified transactions. The step of 
providing at least a portion of the input document to a transaction process 

-11- 
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includes executing a routing process according to a processing architecture at 
the market maker node. The routing process in one aspect of the invention is 
executed according to a particular processing architecture, and at least a portion 
of the incoming document is translated into the format of the processing 
architecture of the routing process. The translating according to the preferred 
aspect includes producing programming objects that include variables and 
methods according to the processing architecture of the routing process. 

According to another aspect of the invention, the market maker node 
also supports the repository structure. Thus, a process is included at the market 
maker node for allowing access by participants in the network to a repository 
stored at the market maker node. As described above, the repository includes 
definitions of logic structures, interpretation information, and document 
definitions for use by the participant nodes to build transaction interface 
documents and includes instances of business interface definitions that identify 
the participants, and the transactions executed by the respective participants. 

The routing process includes according to various alternatives the 
translating of the input document into the variant processing architecture of the 
processes to which the document is to be routed, or routing the input document 
in its original document format across the network to a remote processing node, 
or to combinations of such processes. In alternatives, the routing process may 
also include techniques for transforming an input document defined according 
to one input document definition into a different document defined according to 
a different document specification for a process which has registered to watch 
for the input document. 

Also, the market maker node is provided according to the present 
invention as apparatus that includes a network interface, memory storing data 
and programs of instructions including the specifications of the participant 
interfaces, and a data processor. The logic is provided with the data processor 
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in the form of programs of instructions or otherwise to perform the market 
maker process as discussed above. 

Accordingly, the present invention provides a foundation for electronic 
commerce based on the sharing of specifications of input and output documents. 
Documents provide an intuitive and flexible way to access business services, 
much simpler to implement than programming APIs. It is much easier to 
interconnect companies in terms of documents that are exchanged, on which 
such companies already largely agree, than in terms of business system 
interfaces which invariably differ. In addition, such documents are specified in 
a human readable format in the preferred embodiment. According to the present 
invention the business interfaces are specified in documents, such as XML 
documents that are readily interpretable by humans as well as by computers. 

Utilization of the document based transaction architecture of the present 
invention involves the use of a parser which operates in basically the same way 
for any source of documents, eliminating much of the need for custom programs 
to extract and integrate information from each participant in the network. Thus, 
integrating enterprise information from accounting, purchasing, manufacturing, 
shipping and other functions can be accomplished by first converting each 
source to a document having an architecture according to the present invention, 
and then processing the parsed data stream. Each node in the system that 
participates in the market only needs to know about the format of its internal 
systems, as well as the format of the documents being specified for interchange 
according to the transaction. Thus, there is no need to be able to produce the 
native format of every other node which might want to participate in the 
electronic commerce network. 

For complete business integration, the present invention provides a 
repository of standardized logical structures, like XML elements, attributes or 
meta data, establishing a semantic language for particular commerce 
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communities, a means for mapping between different meta data descriptions, 
and a server for processing the documents and invoking appropriate applications 
and services. The basic building blocks of a network according to the present 
invention include the business interface definitions which tell potential trading 
5 partners what online services a company offers and which documents to use to 

invoke the services; and servers which provide the bridge to bind together the 
set of internal and external business services to create a trading community. 
The server operates to parse the incoming documents and invoke the appropriate 
services. Also the server according to the present invention handles the 

10 translation tasks from the format of the documents being received and 

transmitted, to and from the formats of the respective host systems. Thus, 
trading partners need only agree on the structure, content and sequencing of the 
business documents exchanged, and not on the details of application 
programmer interfaces. How a document is processed and the actions which 

1 5 result from receipt of a document are strictly up to the businesses providing the 

services. This elevates integration from the system level to the business level. 
It enables the business to present a clean and stable interface to its partners 
despite changes in its internal technology implementation, organization or 
processes. 

20 The whole process of building business interface definitions and 

enabling servers to manage commerce according to such descriptions is 
facilitated by a common business library, or repository, of information models 
for generic business concepts including business description primitives like 
companies, services and products, business forms like catalogs, purchase orders 

25 and invoices, and standard measurements, including time and date, location and 

classification of goods. 

Other aspects of the present invention can be seen upon review of the 
figures, the detailed description, and the claims which follow. 
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BRIEF DESCRIPTION OF THE FIGURES 



Fig. 1 is a simplified diagram of an electronic commerce network 
including business interface definitions BIDs according to the present invention. 

Fig. 2 is a simplified diagram of a business interface definition 
5 document according to the present invention. 

Fig. 3 is a conceptual block diagram of a server for a participant node in 
the network of the present invention. 

Fig. 4 is a flow chart illustrating the processing of a received document 
at a participant node according to the present invention. 
10 Fig. 5 is a block diagram of a parser and transaction process front end 

for an XML based system. 

Fig. 6 is a conceptual diagram of the flow of a parse function. 

Fig. 7 is a simplified diagram of the resources at a server used for 
building a business interface definition according to the present invention. 
15 Fig. 8 is a simplified diagram of a repository according to the present 

invention for use for building business interface definitions. 

Fig. 9 is a flow chart illustrating the processes of building a business 
interface definition according to the present invention. 

Fig. 10 provides a heuristic view of a repository according to the present 
20 invention. 

Fig. 1 1 is a simplified diagram of the resources at a server providing the 
market maker function for the network of the present invention based on 
business interface definitions. 

Fig. 12 is a flow chart for the market maker node processing of a 
25 received document. 

Fig. 13 is a flow chart illustrating the process of registering participants 
at a market maker node according to the present invention. 
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Fig. 14 is a flow chart illustrating the process of providing service 
specifications at a market maker node according to the process of Fig. 9. 

Fig. 15 is a diagram illustrating the sequence of operation at a participant 
or market maker node according to the present invention. 
5 Fig. 16 is a conceptual diagram of the elements of a commercial network 

based on BIDs, according to the present invention. 



DETAILED DESCRIPTION 
A detailed description of the present invention is provided with respect 

10 to the figures, in which Fig. 1 illustrates a network of market participants and 

market makers based on the use of business interface definitions, and supporting 
the trading of input and output documents specified according to such interface 
descriptions. The network includes a plurality of nodes 11-18 which are 
interconnected through a communication network such as the Internet 19, or 

15 other telecommunications or data communications network. Each of the nodes 

11-19 consists of a computer, such as a portable computer, a desktop personal 
computer, a workstation, a network of systems, or other data processing 
resources. The nodes include memory for storing the business interface 
definition, processors that execute transaction processes supporting commercial 

20 transactions with other nodes in the network, and computer programs which are 

executed by the processors in support of such services. In addition each of the 
nodes includes a network interface for providing for communication across the 
Internet 19, or the other communication network. 

In the environment of Fig. 1, nodes 11, 12, 13, 14, 16 and 18 are 

25 designated market participants. Market participants include resources for 

consumers or suppliers of goods or services to be traded according to 
commercial transactions established according to the present invention. 
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In this example, nodes 15 and 17 are market maker nodes. The market 
maker nodes include resources for registering business interface definitions, 
called a BID registry. Participants are able to send documents to a market 
maker node, at which the document is identified and routed to an appropriate 
5 participant which has registered to receive such documents as input. The 

market maker also facilitates the commercial network by maintaining a 
repository of standard forms making up a common business library for use in 
building business interface definitions. 

In this example, the market participant 18 is connected directly to the 

10 market maker 17, rather than through the Internet 19. This connection directly 

to the market maker illustrates that the configuration of the networks supporting 
commercial transactions can be very diverse, incorporating public networks 
such as the Internet 19, and private connections such as a local area network or a 
Point-to-Point connection as illustrated between nodes 17 and 18. Actual 

15 communication networks are quite diverse and suitable for use to establish 

commercial transaction networks according to the present invention. 

Fig. 2 is a heuristic diagram of nested structures in a business interface 
definition BID which is established for market participants in the network 
according to the present invention. The business interface definition illustrated 

20 in Fig. 2 is a data structure that consists of logic structures and storage units 

arranged according to a formal definition of a document structure, such as a 
XML document type definition DTD. The structure of Fig. 2 includes a first 
logic structure 200 for identifying a party. Associated with the logic structure 
200 are nested logic structures for carrying the name 201, the physical address 

25 202, the network address or location 203, and a set of transactions for a service 

204. For each transaction in the service set, an interface definition is provided, 
including the transaction BID 205, the transaction BID 206, and the transaction 
BID 207. Within each transaction BID, such as transaction BID 205, logical 
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structures are provided for including a name 208, a location on the network at 
which the service is performed 209, the operations performed by the service 
210, and a set of input documents indicated by the tag 21 1 . Also, the service 
BED 205 includes a set of output documents indicated by the tag 212. The set of 
5 input documents 211 includes a business interface definition for each input 

document for which the services are designed to respond, including input 
document business interface definitions 213, 214, and 215. Each business 
interface definition for an input document includes a name 216, a location on 
the network at which a description of the document can be found 217, and the 

10 modules to be carried in the document as indicated by the field 218. In a similar 

manner, the output document set 212 includes interface definitions for output 
documents including the output document BID 219, output document BID 220, 
and output document BID 221 . For each output document BID, a name 222, a 
location on the network or elsewhere 223, and the modules of the document 224 

15 are specified. The business interface definition for the participant as illustrated 

in Fig. 2 includes actual definitions of a logic structures to be utilized for the 
input and output documents of the respective services, or pointers or other 
references to locations at which these definitions can be found. 

In the preferred system, the document of Fig. 2 is specified in an XML 

20 document type definition DTD, although other document definition 

architectures could be used, and includes interpretation information for the 
logical structures used in interpretation of instances of the documents. In 
addition, each of the transaction BIDs, input document BIDs and output 
document BIDs are specified according to an XML document type definitions. 

25 The XML type document is an example of a system based on parsed data that 

includes mark-up data and character data. Mark-up data identifies logical 
structures within the document and sets of character data identify the content of 
the logical structures. In addition, unparsed data can be carried in the document 
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for a variety of purposes. See for example the specification of the Extensible 
Mark-up Language XML LO REC-XML- 199802 10 published by the WC3 
XML Working Group at WWW.W3.ORG/TR/1998/REC-XML-19980210. 

Thus in an exemplary system, participant nodes in the network establish 
5 virtual enterprises by interconnecting business systems and services with XML 

encoded documents that businesses accept and generate. For example, the 
business interface definition of a particular service establishes that if a 
document matching the BID of a request for a catalog entry is received, then a 
document matching a BID of a catalog entry will be returned. Also, if a 

10 document matching the BID of a purchase order is received, and it is acceptable 

to the receiving terminal, a document matching the BID of an invoice will be 
returned. The nodes in the network process the XML documents before they 
enter the local business system, which is established according to the variant 
transaction processing architecture of any given system in the network. Thus, 

15 the system unpacks sets of related documents, such as MIME-encoded sets of 

XML documents, parses them to create a stream of "mark-up messages". The 
messages are routed to the appropriate applications and services using for 
example an event listener model like that described below. 

The documents exchanged between business services are encoded using 

20 an XML language built from a repository of building blocks (a common 

business language) from which more complex document definitions may be 
created. The repository stores modules of interpretation information that are 
focused on the functions and information common to business domains, 
including business description primitives like companies, services and products; 

25 business forms like catalogs, purchase orders and invoices; standard 

measurements, like time, date, location; classification codes and the like 
providing interpretation information for logical structures in the XML 
documents. 
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The business interface definition is a higher level document that acts as a 
schema used for designing interfaces that trade documents according to the 
present invention. Thus the business interface definition bridges the gap 
between the documents specified according to XML and the programs which 
execute on the front end of the transaction processing services at particular 
nodes. Such front ends are implemented by JAVA virtual machines, or by other 
common architectures providing for interconnection of systems across a 
network. Thus, the business interface definition provides a technique by which 
a transaction protocol is programmed using the business interface definition 
document. The program for the protocol of the transaction is established by a 
detailed formal specification of a document type. 

An example business interface definition BID based on a market 
participant document which conforms to an XML format is provided below. 
The market participant DTD groups business information about market 
participants, associating contact and address information with a description of 
services and financial information. This business information is composed of 
names, codes, addresses, a dedicated taxonomic mechanism for describing 
business organization, and a pointer to terms of business. In addition, the 
services identified by the market participant DTD will specify the input and 
output documents which that participant is expected respond to and produce. 
Thus, documents which define schema using an exemplary common business 
language for a market participant DTD, a service DTD, and a transaction 
document DTD specified in XML with explanatory comments follow: 
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Market Participant Sample 



<!DOCTYPE SCHEMA SYSTEM '*bidLdtd"> 
<SCHEMA> 

5 <Hl>Market Participant Sample BID</H1> 

<META 

WHO.OWNS= M Veo Systems" WHO.COPYRIGHT="Veo Systems" 
WHEN-COPYRIGHT^^S'* DESCRIPTION^' Sample BID" 
WHO. CREATED—'*" WHEN.CREATED—' * M 

10 WHAT.VERSION="*" WHO.MODIFIED-"*" 

WHEN.MODEFIED="* " WHEN.EFFECTTVE- 
WHEN.EXPERES- 1 WHO. EFFECTIVE^'*" 
WHO.EXPIRES-"**^ 
</META> 

15 

<PROLOG> 

<XMLDECL STAND ALONE="no"x/XMLDECL> 
<DOCTYPE NAME-* Wrketparticipant n > 
<SYSTEM>markpart.dtd</SYSTEMx/DOCTYPE> 
20 </PROLOG> 

<DTD NAME="markpartdtd"> 
<H2>Market Participant</H2> 
<H3>Market Participant</H3> 

25 <ELEMENTTYPE NAME="market.participant"> 

<EXPLAIN><TITLE>A Market Participant</TITLE> 

<SYNOPSIS>A business or person and its service interfaces.</SYNOPSIS> 

<P>A market participant is a document definition that is created to describe a business and at 

least one person with an email address, and it presents a set of pointers to service interfaces 

30 located on the network. In this example, the pointers have been resolved and the complete BID 

is presented here.</PX/EXPLAIN> 
<MODEL><CHOICE> 

<ELEMENT NAME= ,t business"x/ELEMENT> 
<ELEMENT NAME— f person"></ELEMENT> 
35 </CHOICE></MODEL></ELEMENTTYPE> 

<H3>Party Prototype</H3> 
<PROTOTYPE NAME="party"> 

<EXPLAIN><TITLE>The Party Prototype</TITLE></EXPLAIN> 
40 <MODEL><SEQUENCE> 

<ELEMENT NAME="party.name n OCCURS= M + H x/ELEMENT> 
<ELEMENT NAME="address.set"x/ELEMENT> 
</SEQUENCEx/MODEL> 
</PROTOTYPE> 



45 



<H3>Party Types</H3> 
<ELEMENTTYPE NAME="business M > 
<EXPLAIN><TITLE>A Business</TITLE> 

<SYNOPSIS>A business (party) with a business number attribute.</SYNOPSIS> 
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<P>This element inherits the content model of the party prototype and adds a business number 

attribute, which serves as a key for database lookup. The business number may be used as a 

cross-reference to/from customer id, credit limits, contacts lists, etc.</Px/EXPLAIN> 

<EXTENDS HREF— 'party "> 

<ATTDEF NAME- 'busmess.number"><R^ 

</EXTENDS> 

</ELEMENTTYPE> 

<H3>Person Name</H3> 
<ELEMENTTYPE NAME="person"> 
<EXPLAINXTITLE>A Person</TITLEx/EXPLAIN> 
<EXTENDS HREF— 'party"> 

<ATTDEF NAME— "S SN"><IMPLIED><yiMPLIED></ATTDEF> 

</EXTENDS> 

</ELEMENTTYPE> 

<H3>Party Name</H3> 
<ELEMENTTYPE NAME="party.name"> 
<EXPLAINxTITLE>A Party's Name</TITLE> 

<SYNOPSIS>A party's name in a string of character.</SYNOPSISx/EXPLAIN> 

<MODEL><STRING></STRINGx/MODEL> 

</ELEMENTTYPE> 

<H3>Address Set</H3> 
<ELEMENTTYPE NAME="address.set"> 
<MODELxSEQUENCE> 

<ELEMENTNAME=-"address.physicar'x/ELEMENT> 
<ELEMENT NAME="telephone" OCCURS="* M x/ELEMENT> 
<ELEMENT NAME-'fax" OCCURS-" *"x/ELEMENT> 
<ELEMENT NAME= M email" OCCURS="* n x/ELEMENT> 
<ELEMENT NAME-'*internet" OCCURS-"* "></ELEMENT> 
</SEQUENCEx/MODEL> 
</ELEMENTTYPE> 

<H3>Physical Address</H3> 
<ELEMENTTYPE NAME="address.physical"> 
<EXPLAINxTITLE>Physical Address</TITLE> 

<SYNOPSIS>The street address, city, state, and zip code.</SYNOPSIS></EXPLAIN> 

<MODELxSEQUENCE> 

<ELEMENT NAME-"street"x/ELEMENT> 

<ELEMENT NAME="city"x/ELEMENT> 

<ELEMENT NAME="state"x/ELEMENT> 

<ELEMENT NAME="postcode" OCCURS="? n x/ELEMENT> 

<ELEMENT NAME="country"x/ELEMENT> 

</SEQUENCEx/MODEL> 

</ELEMENTTYPE> 

<H3>Street</H3> 

<ELEMENTTYPE NAME="street"> 
<EXPLAINxTITLE>Street Address</TITLE> 
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<SYNOPSIS>Street or postal address. </SYNOPSISx/EXPLAIN> 

<MODEL><STRING></STRING></MODEL> 

</ELEMENTTYPE> 



5 <H3>City</H3> 

<ELEMENTTYPE NAME-"city"> 
<EXPLAIN><TITLE>City Name or Code</TITLE> 

<P>The city name or code is a string that contains sufficient information to identify a city 
within a designated state.</P> 
10 </EXPLAIN> 

<MODEL><STRING></STRING></MODEL> 
</ELEMENTTYPE> 

<H3>State</H3> 
1 5 <ELEMENTTYPE NAME="state"> 

<EXPLAINxTITLE>State ; Province or Prefecture Name or Code</TITLE> 
<P>The state name or code contains sufficient information to identify a state within a 
designated country.</Px/EXPLAIN> 

<MODELxSTRING DATATYPE= n COUNTRY.US.SUBENTITY"></STRING></MODEL> 
20 </ELEMENTTYPE> 

<H3>Postal Code</H3> 
<ELEMENTTYPE NAME="postcode"> 
<EXPLAINxTITLE>Postal Code</TITLE> 
25 <P>A postal code is an alphanumeric code, designated by an appropriate postal authority, that 

is used to identify a location or region within the jurisdiction of that postal authority. Postal 
authorities include designated national postal authorities.<Px/EXPLAIN> 
<MODEL><STRING DATATYPE= M sto 
</ELEMENTTYPE> 

30 

<H3>Country</H3> 
<ELEMENTTYPE NAME="country n > 
<EXPLAIN><TITLE>Country Code</TITLE> 

<P>A country code is a two-letter code, designated by ISO, that is used to uniquely identify a 
35 country. </PX/EXPLAIN> 

<MODELxSTRING DATATYPE= ,, country r, x/STRINGx/MODEL> 
</ELEMENTTYPE> 

<H3>Network Addresses</H3> 
40 <ELEMENTTYPE NAME="telephone"> 

<EXPLAIN><TITLE>Telephone Number</TITLE> 

<P>A telephone number is a string of alphanumerics and punctuation that uniquely identifies a 
telephone service terminal, including extension number.</P></EXPLAIN> 
<MODELxSTRINGx/STRINGx/MODEL> 
45 </ELEMENTTYPE> 



<H3>Fax</H3> 

<ELEMENTTYPE NAME— Tax"> 
<EXPLAINxTITLE>Fax Number</TITLE> 
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<P>A fax number is a string of alphanumerics and punctuation that uniquely identifies a fax 

service terminal.</P> 

</EXPLAIN> 

<MODELxSTRINGx/STRING></MODEL> 
5 </ELEMENTTYPE> 

<H3>Email</H3> 

<ELEMENTTYPE NAME- n email"> 
<EXPLAINxTITLE>Email Address</TITLE> 
10 <P>An email address is a datatype-constrained string that uniquely identifies a mailbox on a 

server.</P></EXPLAIN> 

<MODELxSTRING D ATATYPE=" emair , x/STRINGx/MODEL> 
</ELEMENTTYPE> 

1 5 <H3>Internet Address</H3> 

<ELEMENTTYPE NAME="internet"> 
<EXPLAINxTITLE>Internet Address</TITLE> 

<P>An Internet address is a datatype-constrained string that uniquely identifies a resource on 
the Internet by means of a URL.</Px/EXPLAIN> 
20 <MODELxSTRINGDATATYPE= ,, url"x/STRINGx/MODEL> 
</ELEMENTTYPE> 



25 



</DTD> 
</SCHEMA> 

Service Description Sample 



<!DOCTYPE schema SYSTEM "bidl.dtd"> 
<SCHEMA> 

30 <Hl>Service Description Sample BID</H1> 

<META 

WHO.OWNS=''Veo Systems" WHO.COPYRIGHT="Veo Systems" 
WHEN.COPYRIGHT-"1998" DESCRIPTION-" Sample BID" 
WHO.CREATED-'*" WHEN. CREATED-"*" 

35 WHAT.VERSION="* n WHO.MODIFIED="* n 

WHEN.MODIFIED— ' * M WHEN.EFFECTIVE= n * " 

WHEN.EXPIRES="*" WHO.EFFECTiVE="*" 
WHO.EXPIRES="* n > 
</META> 

40 

<PROLOG> 

<XMLDECL STAND ALONE— 'no "x/XMLDECL> 
<DOCTYPE NAME="service"> 
<SYSTEM>service.dtd</SYSTEMx/DOCTYPE> 
45 </PROLOG> 

<DTD NAME="service.dtd"> 
<H2>Services</H2> 

50 <H3>Includes</H3> 
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<!-- INCLUDE><SYSTEM>coniments.bim</SYSTEM></INCLUDE --> 



10 



<H3>Service Set</H3> 
<ELEMENTTYPE NAME="service.set"> 
<EXPLAIN><TITLE>Service Set</TITLE> 
<SYNOPSIS>A set of services. </SYNOPSISx/EXPLAIN> 
<MODEL> 

<ELEMENT NAME="service" OCCURS="+ M x/ELEMENT> 
</MODEL></ELEMENTTYPE> 



<H3>Services Prototype</H3> 

<PROTOTYPE NAME="prototype.service"> 

<EXPLAIN><TITLE>Service</TITLEx/EXPLAIN> 

<MODEL><SEQUENCE> 
1 5 <ELEMENT NAME- 'service. name'></ELEMENT> 

<ELEMENT NAME="service.terms n OCCURS="+"x/ELEMENT> 

<ELEMENT NAME="service.location" OCCURS="H- M x/ELEMENT> 

<ELEMENT NAME= ,, service.operation" OCCURS="+"x/ELEMENT> 

</SEQUENCEx/MODEL> 
20 <!-- ATTGROUPxIMPLEMENTS 

HREF= n common.attrib ,t x/IMPLEMENTSx/ATTGROUP --> 

</PROTOTYPE> 



<H3>Service</H3> 

25 <INTROxP>A service is an addressable network resource that provides interfaces to specific 

operations by way of input and output documents.</Px/INTRO> 
<ELEMENTTYPE NAME="service"> 
<EXPLAINxTITLE>Service</TITLE> 

<P>A service is defined in terms of its name, the location(s) at which the service is available, 
30 and the operation(s) that the service performs. </Px/EXPLAEST> 

<MODEL><SEQUENCE> 

<ELEMENT NAME=" service. name"x/ELEMENT> 
<ELEMENT NAME- ' service .location"x/ELEMENT> 
<ELEMENT NAME="service.operation" OCCURS="+ M x/ELEMENT> 
3 5 <ELEMENT NAME=" service .terms"></ELEMENT> 

</SEQUENCEx/MODEL> 
</ELEMENTTYPE> 



<H3>Service Name</H3> 
40 <ELEMENTTYPE NAME="service.name n > 

<EXPLAIN><TITLE>Service Name</TITLE> 

<P>The service name is a human-readable string that ascribes a moniker for a service. It may be 
employed is user interfaces and documentation, or for other purposes.</Px/EXPLAIN> 
<MODELxSTRINGx/STRINGx/MODEL> 
45 </ELEMENTTYPE> 



<H3>Service Location</H3> 
<ELEMENTTYPE NAME="service.location"> 
<EXPLAIN><TITLE>Service Location</TITLE> 
5 0 <SYNOPSIS>A URI of a service.</SYNOPSIS> 
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<P>A service location is a datatype-constrained string that locates a service on the Internet by 
means of a URI.</Px/EXPLAIN> 

<MODEL><STRING DATATYPE= H url"></STRING></MODEL> 
</ELEMENTTYPE> 

<H3>Service Operations</H3> 

<INTRO><P>A service operation consists of a name, location and its interface, as identified by 
the type of input document that the service operation accepts and by the type of document that it 
will return as a result</Px/INTRO> 
<ELEMENTTYPE NAME="service.operation"> 
<EXPLAINxTITLE>Service Operations</TITLE> 

<P>A service operation must have a name, a location, and at least one document type as an 
input, with one or more possible document types returned as a result of the operation.</P> 
</EXPLAIN> 
<MODEL><SEQUENCE> 

<ELEMENTNAME-'service.operation.name n ></ELEMENT> 

<ELEMENTNAME=="service.operation.location"></ELEMENT> 

<ELEMENTNAME= n service.operation.input"></ELEMENT> 

<ELEMENT NAME= M service . operation. output"x/ELEMENT> 

</SEQUENCE></MODEL> 

</ELEMENTTYPE> 

<H3>Service Operation Name</H3> 
<ELEMENTTYPENAME= ,, service.operation.name n > 
<EXPLAINxTITLE>Service Operation Name</TITLE> 

<P>The service operation name is a human-readable string that ascribes a moniker to a service 

operation. It may be employed in user interfaces and documentation, or for other 

purposes.</Px/EXPLAIN> 

<MODEL><STRINGx/STRINGx/MODEL> 

</ELEMENTTYPE> 

<H3>Service Operation Location</H3> 

<INTROxP>The service location is a network resource. That is to say, a URI.</Px/lNTRO> 
<ELEMENTTYPE NAME- 1 service . operation.location"> 
<EXPLAINxTITLE>Service Operation Location</TITLE> 
<SYNOPSIS>A Uia of a service operation.</SYNOPSIS> 

<P>A service operation location is a datatype-constrained string that locates a service operation 
on the Internet by means of a URL.</PX/EXPLAIN> 
<MODELxSTRING DATATYPE="urr f ></STRINGx/MODEL> 
</ELEMENTTYPE> 

<H3>Service Operation Input Document</H3> 

<INTROxP>The input to a service operation is defined by its input document type. That is, 
the service operation is invoked when the service operation location receives an input document 
whose type corresponds to the document type specified by this element </P> 
<P>Rather than define the expected input and output document types in the market participant 
document, this example provides pointers to externally-defined BIDs. This allows reuse of the 
same BID as the input and/or output document type for multiple operations. In addition, it 
encourages parallel design and implementation.</P></INTRO> 
<ELEMENTTYPENAME= T, service.operation.input n > 
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<EXPLAIN><TITLE>Service Operation Input</TITLE> 

<SYNOPSIS>Identifies the type of the service operation input document </SYNOPSIS> 
<P>Service location input is a datatype-constrained string that identifies a BID on the Internet 
by means of a URL</P> 
5 </EXPLAIN> 

<MODELxSTRING DATATYPE= ,, url M x/STRINGx/MODEL> 
</ELEMENTTYPE> 



<H3>Service Operation Output Document Type</H3> 
1 0 <INTROxP>The output of a service operation is defined by its output document type(s). That 

is, the service operation is expected to emit a document whose type corresponds to the 

document type specified by this element </P></INTRO> 

<ELEMENTTYPE NAME="service . operation.output ,T > 

<EXPLAINxTITLE>Service Operation Output</TITLE> 
1 5 <S YNOPSIS>Identifies the type of the service operation output document </S YNOPSIS> 

<P>Service location output is a datatype-constrained string that identifies a BID on the Internet 

by means of a URL</P> 

</EXPLAIN> 

<MODELxSTRING DATATYPE-"url n x/STRINGx/MODEL> 
20 </ELEMENTTYPE> 

<H3>Service Terms</H3> 

<INTROxP>This is a simple collection of string elements, describing the terms of an 
agreement</Px/INTRO> 
25 <ELEMENTTYPE NAME-^ervice.terms'^ 

<EXPLAINXTITLE>Service Terms</TITLE> 

<SYNOPSIS>Describes the terms of a given agreement </SYNOPSIS> 
</EXPLAIN> 

<MODELxSTRING DATATYPE="string n x/STRINGx/lvIODEL> 
30 </ELEMENTTYPE> 

</DTD> 
</SCHEMA> 

35 The service DTD schema may be extended with a service type element 

in a common business language repository as follows: 



40 



45 



<! ELEMENT service.type EMPTY> 
<! ATTLIST service.type 

service.type.name ( 

catalog.operator 

| commercial.directory.operator 

| efLservices.provider 

| escrower 

| fulfillment.service 

| insurer 

| manufacturer 

| marketoperator 
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I order. originator 

| ordering. service 

| personal.services. provider 

| retailer 

| retail.aggregator 

| schema.resolution. service 

| service.provider 

| shipment, acceptor 

| shipper 

| van 

| wholesale.aggregator 
) #REQUIRED 
%common.attrib; 

> 

The service type element above illustrates interpretation information 
carried by a business interface definition, in this example a content form 
allowing identification of any one of a list of valid service types. Other 
interpretation information includes data typing, such as for example the element 
<H3>Internet Address</H3> including the content form "url" and expressed in 
the data type "string." Yet other interpretation information includes mapping of 
codes to elements of a list, such as for example the element <H3>State</H3> 
including the code mapping for states in the file 
"COUNTRY.US.SUBENTITY." 

The service description referred to by the market participant DTD 
defines the documents that the service accepts and generates upon competition 
of the service. A basic service description is specified below as a XML 
document transact.dtd. 

Transact.dtd models a transaction description, such as an invoice, or a 
description of an exchange of value. This document type supports many uses, 
so the transaction description element has an attribute that allows user to 
distinguish among invoices, performance, offers to sell, requests for quotes and 
so on. The exchange may occur among more than two parties, but only two are 
called out, the offeror and the counter party, each of whom is represented by a 
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pointer to a document conforming to the market participant DTD outlined 
above. The counter party pointer is optional, to accommodate offers to sell. 
The exchange description is described in the module tranprim.mod listed below, 
and includes pricing and subtotals. Following the exchange description, charges 
applying to the transaction as a whole may be provided, and a total charge must 
be supplied. Thus, the transaction description schema document transact.dtd for 
this example is set forth below: 

< ! — transact.dtd Version: 1 . 0 — > 

<!-- Copyright 1998 Veo Systems, Inc. --> 



<! ELEMENT transaction.description (meta?, issuer .pointer, 

counterparty .pointer?, exhange.descrption+, general.charges?, 
15 net.total?)> 

<! ATTLIST transaction.description 

transaction. type (invoice | pro.forma | offer.to.sell | order 
| request. for. quote | request. for. bid 
| request.for.proposal | response.to.request.for.quote 
20 I response. to .requestfor .bid 

| response.to.requestfor.proposal) "invoice" 
%common.attrib; 
%altrep.attrib; 
%ttl.attrib; 

25 > 

Representative market participant, and service DTDs, created according 
to the definitions above, are as follows: 

30 Market Participant DTD 

<! ELEMENT business (party . name+ , address.set) > 

<! ATTLIST business business.number CDATA #REQUIRED 

> 

35 <!ELEMENT party.name (#PCDATA )> 

<!ELEMENT city (#PCDATA )> 

<! ELEMENT internet (#PCDATA )> 

<! ELEMENT country (#PCDATA )> 

<! ELEMENT state (#PCDATA )> 
40 <! ELEMENT email (#PCDATA )> 

<!ELEMENT address.physical (street , city , state , postcode? , country) > 

<!ELEMENT telephone (#PCDATA )> 

<! ELEMENT person (party .name+ , address.set) > 
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<! ATTLIST person SSN CD ATA #IMPLIED 

> 

<! ELEMENT fax (#PCDATA )> 
<! ELEMENT street (#PCDATA )> 
5 <! ELEMENT address.set (address.physical , telephone* , fax* , email* , internet*) > 

<! ELEMENT postcode (#PCDATA )> 
<! ELEMENT marketparticipant (business | person) > 



Service DTD 



10 



<!ELEMENT service.location (#PCDATA )> 

<!ELEMENT service.terms (#PCDATA )> 

<! ELEMENT service.operation.name (#PCDATA )> 

<!ELEMENT service.operation (service.operation.name , service. operation.location , 
15 service.operation.input , service.operation.output) > 

<!ELEMENT service (service.name , service.location , service. operations , service.terms) > 

<! ELEMENT service.operation.input (#PCDATA )> 

<! ELEMENT service.operation.location (#PCDATA )> 

<! ELEMENT service.name (#PCDATA )> 
20 <! ELEMENT service.set (service^ )> 

<!ELEMENT service.operation.output (#PCDATA )> 



One instance of a document produced according to the transact.dtd 
follows: 

25 

<?xml version-" 1.0"?> 

<!— rorder.xml Version: 1.0 — > 

<!-- Copyright 1998 Veo Systems, Inc. »> 

3 0 <!DOCTYPE transaction.description SYSTEM "urn:x- 

veosy stems :dtd:cbl: transact: 1 .0:> 
<transaction. description transaction.type- 'order"> 
<meta> 

<urn?urn:x-veosy stems : doc : 00023 
35 </urn> 

<thread.id party.assigned.by : = n reqorg n >FRT876 
</thread.id> 

</meta> 

<issuer.pointer> 

40 <xll.locator urllink="reqorg.xrnl">Customer 

Pointer 
</xll.locator> 
</issuer.pointer> 
<counterparty.pointer> 

45 <xll.locator urllink="compu.xml M >Catalog entry owner 

pointer 
</xll.locator> 
</counterparty.pointer> 
<exchange.description> 
50 <line.item> 
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<product.instance> 
<product.description.pointer> 

<xll.locator urllink="cthink.xml">Catalogue Entry Pointer 

</xll.locator> 

5 </product.description.pointer> 

<product.specifics> 
<inf o . description. set> 
<info.description> 
<xml.descriptor> 
10 <doctype> 

<dtd system. id= M urn:x- veosy stems :dtd:cbl:gprod: 1.0"/> 
</doctype> 

<xml.descriptor.details> 

<xll.xptr.frag>DESCENDANT(ALL,os)STRING( ?, Windows 

15 95") 

</xll.xptr.frag> 

<xll.xptr.frag>DECENDANT(ALL ) p.speed)STRING("200") 
</xll.xptr.frag> 

<xlLxptr.frag>DESCENDANT(ALL ? hard.disk.capacity) 
20 STRING("4 M ) 

</xll.xptr.frag> 

<xll.xptr. frag>DESCEND ANT(ALL,d.size) STRING( " 14. 1 ") 
</xll.xptr.frag> 
</xml.descriptor.details> 
25 </xmLdescriptor> 
</info . description> 

</info .description. set> 
</product. specifics> 
<quantity>l 
30 </quantity> 

</product.instance> 
<shipment.coordinates.set> 
<shipment.coordinates> 
<shipment.destination> 
35 <address.set> 

<address.named>SW- 1 
</address.named> 
<address.physical> 

<building.sublocation>208C</building.sublocation> 
40 <location.in.street>123 

</location,in.street> 
<street>Frontage Rd. 
</street> 
<city>Beltway 
45 </city> 

<country.subentity.us 

country . subentity. us .name="MD"/> 

<postcode>20000 

</postcode> 

5 0 </address .phy sical> 
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<telephone> 

<telephone.number>6 1 7-666-2000 
</telephone.number> 
<telephone . extension> 1201 
5 </telephone.extension> 

<^telephone> 
</address.set> 
</shipmentdestination> 

1 0 <shipment.special>No deliveries after 4 PM</shipment.special> 

</shipment. coordinates> 
</shipment. coordinates .set> 

<payment.set> 

<credit.card 

15 issuer.name="VTSA M 

instrument.number-"3787-812345-67893" 
expiry.date=" 12/97" 
currency.code= : "USD"/> 
<amount.group> 

20 <amount.monetary cunency.code- TJSD">3975 

</amount.monetary> 
</amount.group> 
</paymentset> 
</line.item> 
25 </exhange.description> 

</transaction.description> 

Accordingly, the present invention provides a technique by which a 
market participant is able to identify itself, and identify the types of input 
30 documents and the types of output documents with which it is willing to 

transact business. The particular manner in which the content carried in such 
documents is processed by the other parties to the transaction, or by the local 
party, is not involved in establishing a business relationship nor carrying out 
transactions. 

35 Fig. 3 provides a simplified view of a participant node in the network 

according to the present invention. The node illustrated in Fig. 3 includes a 
network interface 300 which is coupled to a communication network on port 
301 . The network interface is coupled to a document parser 301 . The parser 
301 supplies the logical structures from an incoming document to a translator 

40 module 302, which provides for translating the incoming document into a form 
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usable by the host transaction system, and vice versa translating the output of 
host processes into the format of a document which matches the output 
document form in the business interface definition for transmission to a 
destination. The parser 301 and translator 302 are responsive to the business 
5 interface definition stored in the participant module 303. 

The output data structures from the translator 302 are supplied to a 
transaction process front end 304 along with events signaled by the parser 301 . 
The front end 304 in one embodiment consists of a JAVA virtual machine or 
other similar interface adapted for communication amongst diverse nodes in a 

10 network. The transaction processing front end 304 responds to the events 

indicated by the parser 301 and the translator 302 to route the incoming data to 
appropriate functions in the enterprise systems and networks to which the 
participant is coupled. Thus, the transaction process front end 304 in the 
example of Fig. 3 is coupled to commercial functions 305, database functions 

15 306, other enterprise functions such as accounting and billing 307, and to the 

specific event listeners and processors 308 which are designed to respond to the 
events indicated by the parser. 

The parser 301 takes a purchase order like that in the example above, or 
other document, specified according to the business interface definition and 

20 creates a set of events that are recognized by the local transaction processing 

architecture, such as a set of JAVA events for a JAVA virtual machine. 

The parser of the present invention is uncoupled from the programs that 
listen for events based on the received documents. Various pieces of mark-up in 
a received document or a complete document meeting certain specifications 

25 serve as instructions for listening functions to start processing. Thus listening 

programs carry out the business logic associated with the document information. 
For example, a program associated with an address element may be code that 
validates the postal code by checking the database. These listeners subscribe to 
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events by registering with a document router, which directs the relevant events 
to all subscribers who are interested in them. 

For example, the purchase order specified above may be monitored by 
programs listening for events generated by the parser, which would connect the 
5 document or its contents to an order entry program. Receipt of product 

descriptions within the purchase order, might invoke a program to check 
inventory. Receipt of address information within the purchase order, would 
then invoke a program to check availability of services for delivery. Buyer 
information fields in the document, could invoke processes to check order 

1 0 history for credit worthiness or to offer a promotion or similar processing based 

on knowing the identity of the consumer. 

Complex listeners can be created as configurations of primitive ones. 
For example, a purchase order listener may contain and invoke the list listeners 
set out in the previous paragraph, or the list members may be invoked on their 

1 5 own. Note that the applications that the listeners run are unlikely to be native 

XML processes or native JAVA processes. In these cases, the objects would be 
transformed into the format required by the receiving trans application. When 
the application finishes processing, its output is then transformed back to the 
XML format for communication to other nodes in the network. 

20 It can be seen that the market participant document type description, and 

the transaction document type description outlined above include a schematic 
mapping for logic elements in the documents, and include mark-up language 
based on natural language. The natural language mark-up, and other natural 
language attributes of XML facilitate the use of XML type mark-up languages 

25 for the specification of business interface definitions, service descriptions, and 

the descriptions of input and output documents. 

The participant module 303 in addition to storing the business interface 
definition includes a compiler which is used to compile objects or other data 
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structures to be used by the transaction process front end 304 which corresponds 
to the logical structures in the incoming documents, and to compile the 
translator 302. Thus, as the business interface definition is modified or updated 
by the participant as the transactions with which the participant is involved 
5 change, the translator 302 and parser 301 are automatically kept up to date. 

In a preferred system, the set of JAVA events is created by a compiler 
which corresponds to the grove model of SGML, mainly the standard Element 
Structure Information Set augmented by the "property set" for each element. 
International Standard ISO/IEC 10179:1996 (E), Information Technology — 

1 0 Processing Languages — Document Style Semantics and Specification 

Language (DSSSL). Turning the XML document into a set of events for the 
world to process contrasts with the normal model of parsing in which the parser 
output is maintained as an internal data structure. By translating the elements of 
the XML document into JAVA events or other programming structures that are 

1 5 suitable for use by the transaction processing front end of the respective nodes 

enables rich functionality at nodes utilizing the documents being traded. 

Thus, the transaction process front end 304 is able to operate in a publish 
and subscribe architecture that enables the addition of new listener programs 
without the knowledge of or impact on other listening programs in the system. 

20 Each listener, 305, 306, 307, 308 in Fig. 3, maintains a queue in which the front 

end 304 directs events. This enables multiple listeners to handle events in 
parallel at their own pace. 

Furthermore, according to the present invention the applications that the 
listeners run need not be native XML functions, or native functions which 

25 match the format of the incoming document. Rather, these listeners may be 

JAVA functions, if the transaction process front end 304 is a JAVA interface, or 
may be functions which run according to a unique transaction processing 
architecture. In these cases, the objects would be transformed into the format 
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required by the receiving application. When the application of the listener 
finishes, its output is then transformed back into the format of a document as 
specified by the business interface definition in the module 303. Thus, the 
translator 302 is coupled to the network interface 300 directly for supplying the 
composed documents as outputs. 

The listeners coupled to the transaction processing front end may 
include listeners for input documents, listeners for specific elements of the input 
documents, and listeners for attributes stored in particular elements of the input 
document. This enables diverse and flexible implementations of transaction 
processes at the participant nodes for filtering and responding to incoming 
documents. 

Fig. 4 illustrates a process of receiving and processing an incoming 
document for the system of Fig. 3. Thus, the process begins by receiving a 
document at the network interface (step 400). The parser identifies the 
document type (401) in response to the business interface definition. Using the 
business interface definition, which stores a DTD for the document in the XML 
format, the document is parsed (step 402). Next, the elements and attributes of 
the document are translated into the format of the host (step 403). In this 
example, the XML logic structures are translated into JAVA objects which carry 
the data of the XML element as well as methods associated with the data such 
as get and set functions. Next, the host objects are transferred to the host 
transaction processing front end (step 404). These objects are routed to 
processes in response to the events indicated by the parser and the translator. 
The processes which receive the elements of the document are executed and 
produce an output (step 405). The output is translated to the format of an output 
document as defined by the business interface definition (step 406). In this 
example, the translation proceeds from the form of a JAVA object to that of 
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an XML document. Finally, the output document is transmitted to its 
destination through the network interface (step 407). 

Fig. 5 is a more detailed diagram of the event generator/event listener 
mechanism for the system of Fig. 3. In general the approach illustrated in Fig. 5 
5 is a refinement of the JAVA JDK 1 . 1 event model. In this model, three kinds of 

objects are considered. A first kind of object is an event object which contains 
information about the occurrence of an event. There may be any number of 
kinds of event objects, corresponding to all the different kinds of events which 
can occur. A second kind of object is an Event generator, which monitors 

10 activity and generates event objects when something happens. Third, event 

listeners, listen for event objects generated by event generators. Event listeners 
generally listen to specific event generators, such as for mouse clicks on a 
particular window. Event listeners call an "ADD event listener" method on the 
event generator. This model can be adapted to the environment of Fig. 3 in 

15 which the objects are generated in response to parsing and walking a graph of 

objects, such as represented by an XML document. 

The system illustrated in Fig. 5 includes a generic XML parser 500. 
Such parser can be implemented using a standard call back model. When a 
parsing event occurs, the parser calls a particular method in an application 

20 object, passing in the appropriate information in the parameters. Thus a single 

application 501 resides with the parser. The application packages the 
information provided by the parser in an XML event object and sends it to as 
many event listeners as have identified themselves, as indicated by the block 
502. The set of events 502 is completely parser independent. The events 502 

25 can be supplied to any number of listeners and any number of threads on any 

number of machines. The events are based on the element structure information 
set ESIS in one alternative. Thus, they consist of a list of the important aspects 
of a document structure, such as the starts and ends of elements, or of the 
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recognition of an attribute. XML (and SGML) parsers generally use the ESIS 
structure as a default set of information for a parser to return to its application. 

A specialized ESIS listener 503 is coupled to the set of events 502. This 
listener 503 implements the ESIS listener API, and listens for all XML events 
5 from one or more generators. An element event generator 504 is a specialized 

ESIS listener which is also an XML event generator. Its listeners are objects 
only interested in events for particular types of elements. For example in an 
HTML environment, the listener may only be interested in ordered lists, that is 
only the part of the document between the <OL> and </OL>tags. For another 

10 example, a listener may listen for "party.name" elements, or for "service.name" 

elements according to the common business language, from the example 
documents above, process the events to ensure that the elements carry data that 
matches the schematic mapping for the element, and react according to the 
process needed at the receiving node. 

15 This allows the system to have small objects that listen for particular 

parts of the document, such as one which only adds up prices. Since listeners 
can both add and remove themselves from a generator, there can be a listener 
which only listens to for example the <HEAD> part of an HTML document. 
Because of this and because of the highly recursive nature of XML documents, 

20 it is possible to write highly targeted code, and to write concurrent listeners. 

For example, an <OL> listener can set up an <LI> listener completely separate 
from the manner in which the <UL> (unordered list) listener sets up its <LI> 
listener. Alternatively, it can create a listener which generates a graphic user 
interface and another which searches a database using the same input. Thus, the 

25 document is treated as a program executed by the listeners, as opposed to the 

finished data structure which the application examines one piece at a time. If an 
application is written this way, it is not necessary to have the entire document in 
memory to execute an application. 
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The next listener coupled to the set of events 502 is an attribute filter 
505. The attribute filter 505 like the element filter 504 is an attribute event 
generator according to the ESIS listener model. The listener for an attribute 
filter specifies the attributes it is interested in, and receives events for any 
element having that attribute specified. So for example, a font manager might 
receive events only for elements having a font attribute, such as the <P FONT= 
"Times Roman" /P>. 

The element event generator 504 supplies such element objects to 
specialize the element listeners 504A. 

The attribute event generator 505 supplies the attribute event objects to 
attribute listeners 5 05 A. Similarly, the attribute objects are supplied to a 
"architecture" in the sense of an SGML/XML transformation from one 
document type to another using attributes. Thus the architecture of 505B allows 
a particular attribute with a particular name to be distinguished. Only elements 
with that attribute defined become part of the output document, and the name of 
the element in the output document is the value of the attribute in the input 
document. For example, if the architecture 505B is HTML, the string: 

<PURCHASES HTML-"OL"><ITEM HTML="LI"><NAME 

HTML="B">STUFF</NAME><PRICE 

HTML="B">1 23</PRICE></ITEM></PURCHASES> 
translates into: 

<OL><LI><B>STUFF</B><B>123</Bx/LI></OL> 
which is correct HTML. 

The next module which is coupled to the set of events 502 is a tree 
builder 506. The tree builder takes a stream of XML events and generates a tree 
representation of the underlying document. One preferred version of the tree 
builder 506 generates a document object model DOM object 507, according to 
the specification of the W3C (See, http://www.w3.org/TR/1998/ 
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WD-DOM- 19980720/ introduction.html). However listeners in event streams 
can be used to handle most requirements, a tree version is useful for supporting 
queries around a document, reordering of nodes, creation of new documents, 
and supporting a data structure in memory from which the same event stream 
5 can be generated multiple times, for example like parsing the document many 

times. A specialized builder 508 can be coupled to the tree builder 506 in order 
to build special subtrees for parts of the document as suits a particular 
implementation. 

In addition to responses to incoming documents, other sources of XML 

10 events 502 can be provided. Thus, an event stream 510 is generated by walking 

over a tree of DOM objects and regenerating the original event stream created 
when the document was being parsed. This allows the system to present the 
appearance that the document is being parsed several times. 

The idea of an object which walks a tree and generates a stream of 

15 events can be generalize beyond the tree of DOM objects, to any tree of objects 

which can be queried. Thus, a JAVA walker 512 may be an application which 
walks a tree of JAVA bean components 513. The walker walks over all the 
publicly accessible fields and methods. The walker keeps track of the objects it 
has already visited to ensure that it doesn't go into an endless cycle. JAVA 

20 events 514 are the type of events generated by the JAVA walker 512. This 

currently includes most of the kinds of information one can derive from an 
object. This is the JAVA equivalent of ESIS and allows the same programming 
approach applied to XML to be applied to JAVA objects generally, although 
particularly to JAVA beans. 

25 The JAVA to XML event generator 515 constitutes a JAVA listener and 

a JAVA event generator. It receives the stream of events 514 from the JAVA 
walker 512 and translates selected ones to present a JAVA object as an XML 
document. In the one preferred embodiment, the event generator 515 exploits 
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the JAVA beans API. Each object seen becomes an element, with the element 
name the same as the class name. Within that element, each embedded method 
also becomes an element whose content is the value returned by invoking the 
method. If it is an object or an array of objects, then these are walked in turn. 
5 Fig. 6 outlines a particular application built on the framework of Fig. 5. 

This application takes in an XML document 600 and applies it to a 
parser/generator 601. ESIS events 602 are generated and supplied to an 
attribute generator 603 and tree builder 604. The attribute generator 
corresponds to the generator 505 of Fig. 5. It supplies the events to the 

10 "architecture" 505B for translating the XML input to an HTML output for 

example. These events are processed in parallel as indicated by block 605 and 
processed by listeners. The output of the listeners are supplied to a document 
writer 506 and then translated back to an XML format for output. Thus for 
example this application illustrated in Fig. 6 takes an XML document and 

1 5 outputs an HTML document containing a form. The form is then sent to a 

browser, and the result is converted back to XML. For this exercise, the 
architecture concept provides the mapping from XML to HTML. The three 
architectures included in Fig. 6 include one for providing the structure of the 
HTML document, such as tables and lists, a second specifying text to be 

20 displayed, such as labels for input fields on the browser document, and the third 

describes the input fields themselves. The elements of the XML document 
required to maintain the XML documents structure become invisible fields in 
the HTML form. This is useful for use in reconstruction of the XML document 
from the information the client will put into the HTTP post message that is sent 

25 back to the server. Each architecture takes the input document and transforms it 

into an architecture based on a subset of HTML. Listeners listening for these 
events, output events for the HTML document, which then go to a document 
writer object. The document writer object listens to XML events and turns them 
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back into an XML document. The document writer object is a listener to all the 
element generators listening to the architectures in this example. 

The organization of the processing module illustrated in Figs. 5 and 6 is 
representative of one embodiment of the parser and transaction process front 
5 end for the system of Fig. 3. As can be seen, a very flexible interface is 

provided by which diverse transaction processes can be executed in response to 
the incoming XML documents, or other structured document formats. 

Fig. 7 illustrates a node similar to that of Fig. 3, except that it includes a 
business interface definition builder module 700. Thus, the system of Fig. 7 

10 includes a network interface 701, a document parser 702, and a document 

translator 703. The translator 703 supplies its output to a transaction processing 
front end 704, which in turn is coupled to listening functions such as 
commercial functions 705, a database 706, enterprise functions 707, and other 
generic listeners and processors 708. As illustrated in Fig. 7, the business 

15 interface definition builder 700 includes a user interface, a common business 

library CBL repository, a process for reading complementary business interface 
definitions, and a compiler. The user interface is used to assist an enterprise in 
the building of a business interface definition relying on the common business 
library repository, and the ability to read complementary business interface 

20 definitions. Thus, the input document of a complementary business interface 

definition can be specified as the output document of a particular transaction, 
and the output document of the complementary business interface definition can 
be specified as the input to such transaction process. In a similar manner a 
transaction business interface definition can be composed using components 

25 selected from the CBL repository. The use of the CBL repository encourages 

the use of standardized document formats, such as the example schema (bidl) 
documents above, logical structures and interpretation information in the 
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building of business interface definitions which can be readily adopted by other 
people in the network. 

The business interface definition builder module 700 also includes a 
compiler which is used for generating the translator 703, the objects to be 
5 produced by the translator according to the host transaction processing 

architecture, and to manage the parsing function 702. 

Fig. 8 is a heuristic diagram showing logical structures stored in the 
repository in the business interface definition builder 700. Thus, the repository 
storage representative party business interface definitions 800, including for 

10 example a consumer BID 801 , a catalog house BID 802, a warehouse BED 803, 

and an auction house BID 804. Thus, a new participant in an online market may 
select as a basic interface description one of the standardized BIDs which best 
matches its business. In addition, the repository will store a set of service 
business interface definitions 805. For example, an order entry BID 806, an 

15 order tracking BID 807, an order fulfillment BID 808, and a catalog service BED 

809 could be stored. As a new participant in the market builds a business 
interface definition, it may select the business interface definitions of 
standardized services stored in the repository. 

In addition to the party and service BIDs, input and output document 

20 BIDs are stored in the repository as indicated by the field 810. Thus, a purchase 

order BID 81 1, an invoice BED 812, a request for quote BID 813, a product 
availability report BED 814, and an order status BID 815 might be stored in the 
repository. 

The repository, in addition to the business interface definitions which in 
25 a preferred system are specified as document type definitions according to 

XML, stores interpretation information in the form of semantic maps as 
indicated by the field 816. Thus, semantic maps which are used for specifying 
weights 817, currencies 818, sizes 819, product identifiers 820, and product 
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features 821 in this example might be stored in the repository. Further, the 
interpretation information provides for typing of data structures within the 
logical structures of documents. 

In addition, logical structures used in the composing of business 
5 interface definitions could be stored in the repository as indicated by block 822. 

Thus, forms for providing address information 823, forms for providing pricing 
information 824, and forms for providing terms of contractual relationships 
could be provided 825. As the network expands, the CBL repository will also 
expand and standardize tending to make the addition of new participants, and 

10 the modification of business interface definitions easier. 

Fig. 9 illustrates the process of building a business interface definition 
using the system of Fig. 7. The process begins by displaying a BID builder 
graphical interface to the user (step 900). The system accepts user input 
identifying a participant, service and document information generated by the 

1 5 graphical interface (step 901). 

Next, any referenced logical structures, interpretation information, 
document definitions and/or service definitions are retrieved from the repository 
in response to user input via the graphical user interface (step 902). In the next 
step, any complementary business interface definitions or components of 

20 business interface definitions are accessed from other participants in the 

network selected via user input, by customized search engines, web browsers or 
otherwise (step 903). A document definition for the participant is created using 
the information gathered (step 904). The translators for the document to host 
and host to document mappers are created by the compiler (step 905). Host 

25 architecture data structures corresponding to the definition are created by the 

compiler (step 906), and the business interface definition which has been 
created is posted on the network, such as by posting on a website or otherwise, 
making it accessible to other nodes in the network (step 907). 
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Business interface definitions tell potential trading partners the online 
services the company offers and which documents to use to invoke those 
services. Thus, the services are defined in the business interface definition by 
the documents that they accept and produce. This is illustrated in the following 
fragment of an XML service definition. 

<service> 

<service.name>Order Service</ service.name> 
<service .location>www. veosy stems . com/ order</ service.location> 
<service.op> 

<service.op.name>Submit Order</ service.op.name> 
<service .op.inputdoc>wwwxommerce.net/po . dtd</service . op .inputdoc> 
<service.op.outputdoc> 

www. veosystems .com/ invoice .dtd</service. op . outputdoc> 
</service.op> 

< service. op> 

< service.op.name>Track Order</service.op.name> 
<service . op.inputdoc> www. commerce.net 

/request. track.dtd<service.op.inputdoc> 
<service.op.outputdoc> 

www. veosy stems . com/response.track. dtd<service.op.outputdoc> 
</service.op> 
</service> 

This XML fragment defines a service consisting of two transactions, one 
25 for taking orders and the other for tracking them. Each definition expresses a 

contract or promise to carry out a service if a valid request is submitted to the 
specified Web address. The Order service here requires an input document that 
conforms to a standard "po.dtd" Document Type Definition located in the 
repository, which may be local, or stored in an industry wide registry on the 
30 network. If a node can fulfill the order, it will return a document conforming to 

a customized "invoice.dtd" whose definition is local. In effect, the company is 
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promising to do business with anyone who can submit a Purchase Order that 
conforms to the XML specification it declares. No prior arrangement is 
necessary. 

The DTD is the formal specification or grammar for documents of a 
given type; it describes the elements, their attributes, and the order in which 
they must appear. For example, purchase orders typically contain the names 
and addresses of the buyer and seller, a set of product descriptions, and 
associated terms and conditions such as price and delivery dates. In Electronic 
Data Interchange EDI for example, the X12 850 specification is a commonly 
used model for purchase orders. 

The repository encourages the development of XML document models 
from reusable semantic components that are common to many business 
domains. Such documents can be understood from their common message 
elements, even though they may appear quite different. This is the role of the 
Common Business Library repository. 

The Common Business Library repository consists of information 
models for generic business concepts including: 

• business description primitives like companies, services, and 
products; 

• business forms like catalogs, purchase orders, and invoices; 

• standard measurements, date and time, location, classification 
codes. 

This information is represented as an extensible, public set of XML 
building blocks that companies can customize and assemble to develop XML 
applications quickly. Atomic CBL elements implement industry messaging 
standards and conventions such as standard ISO codes for countries, currencies, 
addresses, and time. Low level CBL semantics have also come from analysis of 
proposed metadata frameworks for Internet resources, such as Dublin Core. 
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The next level of elements use these building blocks to implement the 
basic business forms such as those used in XI 2 EDI transactions as well as 
those used in emerging Internet standards such as OTP (Open Trading Protocol) 
and OBI (Open Buying on the Internet). 

CBL's focus is on the functions and information that are common to all 
business domains (business description primitives like companies, services, and 
products; business forms like catalogs, purchase orders, and invoices; standard 
measurements, date and time, location, classification codes). CBL builds on 
standards or industry conventions for semantics where possible (e.g., the rules 
that specify "day/month/year" in Europe vs "month/day/year" in the U.S. are 
encoded in separate CBL modules). 

The CBL is a language that is used for designing applications. It is 
designed to bridge the gap between the "document world" of XML and the 
"programming world" of JAVA or other transaction processing architectures. 
Schema embodies a philosophy of "programming with documents" in which a 
detailed formal specification of a document type is the master source from 
which a variety of related forms can be generated. These forms include XML 
DTDs for CBL, JAVA objects, programs for converting XML instances to and 
from the corresponding JAVA objects, and supporting documentation. 

The CBL creates a single source from which almost all of the pieces of a 
system can be automatically generated by a compiler. The CBL works by 
extending SGML/XML, which is normally used to formally define the 
structures of particular document types, to include specification of the semantics 
associated with each information element and attribute. The limited set of 
(mostly) character types in SGML/XML can be extended to declare any kind of 
datatype. 
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Here is a fragment from the CBL definition for the "datetime" module: 



<!-- datetimcmod Version: 1.0— > 

<!-- Copyright 1998 Veo Systems, Inc. --> 

<! ELEMENT year (#PCDATA)> 
<! ATTLIST year 

schema CD ATA #FIXED "urn:x-veosystems:stds:iso:8601:3.8" 

> 

<! ELEMENT month (#PCDATA)> 
<! ATTLIST month 

schema CDATA #FIXED "urn:x-veosystems:stds:iso:8601:3.12" 

> 



In this fragment, the ELEMENT "year" is defined as character data, and 
an associated "schema" attribute, also character data, defines the schema for 
"year" to be section 3.8 of the ISO 8601 standard. 

This "datetime" CBL module is in fact defined as an instance of the 
Schema DTD. First, the module name is defined. Then the "datetime" element 
"YEAR" is bound to the semantics of ISO 8601: 

<! DOCTYPE SCHEMA SYSTEM "schema.dtd"> 
<SCHEMAxH 1 >Date and Time Module</Hl> 



<ELEMNTTYPE NAME="year" DATATYPE="YEAR"><MODEL> 
<STRING 

DATATYPE-"YEAR"></STRING></MODEL> 
<ATTDEF NAME=:schema:iso8601" DATATYPE- 'CD ATA"> 
<FIXED>3.8 

Gregorian calendar</FIXED><yATTDEF></ELEMENTTYPE> 



The example market participant and service modules above are also 
stored in the CBL repository. 

In Fig. 10, an Airbill 1000 is being defined by customizing a generic 
purchase order DTD 1001, adding more specific information about shipping 
weight 1002. The generic purchase order 1001 was initially assembled from the 
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ground up out of CBL modules for address, date and time, currency, and vendor 
and product description. Using CBL thus significantly speeds the development 
and implementation of XML commerce applications. More importantly, CBL 
makes it easier for commercial applications to be interconnected. 

In the CBL, XML is extended with a schema. The extensions add 
strong-typing to XML elements so that content can be readily validated. For 
example, an element called <CPU_clock_speed> can be defined as an integer 
with a set of valid values: {100, 133, 166, 200, 233, 266 Mhz.}. The schema 
also adds class-subclass hierarchies, so that information can be readily 
instantiated from class definitions. A laptop, for instance, can be described as a 
computer with additional tags for features such as display type and battery life. 
These and other extensions facilitate data entry, as well as automated 
translations between XML and traditional Object-Oriented and relational data 
models. 

Thus the completed BID is run through the compiler which produces the 
DTDs for the actual instance of a participant and a service as outlined above, the 
JAVA beans which correspond to the logical structures in the DTD instances, 
and transformation code for transforming from XML to JAVA and from JAVA 
to XML. In alternative systems documentation is also generated for display on 
a user interface or for printing by a user to facilitate use of the objects. 

For the example market participant and service DTDs set forth above, 
the JAVA beans generated by the compiler are set forth (with some redactions 
for conciseness) as follows: 

import com. veo . vsp . docletmeta.Document; 
public class AddressPhysical extends Document { 

public static final String DOC TYPE - "address. physical"; 

String mStreet; 

String mCity; 

public final static int AK = 0; 
public final static int AL = 1; 
public final static int AR = 2; 
public final static int AZ — 3; 
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public final static int CA = 4; 



public final static int WI = 48; 
5 public final static int WV = 49; 

public final static int WY = 50; 
int mState; 
String mPostcode; 
public final static int AD = 51; 
1 0 public final static int AE = 52; 

public final static int AF = 53; 
public final static int AG = 54; 
public final static int AI = 55; 
public final static int AM = 56; 

15 

int mCountry; 
public AddressPhysical(){ 

super(DOC_TYPE); 
20 mStreet = new String(); 

mCity = new String(); 

fhis.mState--l; 
mPostcode = null; 

this .mCountry = -1; 

25 } 

public AddressPhysical(String doc_type){ 

super(doctype); 
mStreet = new String(); 
mCity = new String(); 
30 this.mState = -l; 

mPostcode = null; 

this. mCountry = -1: 

} 

' static public AddressPhysical initAddressPhysical(String iStreet, String iCityjint 
35 iState,String iPostcode,int iCountry){ 

AddressPhysical obj = new AddressPhysical(); 
obj.initializeAll(iStreet 5 iCity, iState, iPostcode, iCountry); 
return obj; 

} 

40 

public void mitializeAll(String iStreet, String iCity,int iState,String iPostcode,int 
iCountry) { 

mStreet = iStreet; 
mCity = iCity; 
45 mState = iState; 

mPostcode = iPostcode; 
mCountry - iCountry; 

} 

public String getStreet(){ 
5 0 return mStreet; 
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} 

public String getStreetToXML() { 

if (getStreet() = null) return null; 
char [] c = getStreet().toCharArray(); 
5 StringBuffer sb = new StringBuffer(); 

for (int x = 0; x < c.length; x++){ 
switch(c[x]){ 
case '>': 
sb.append(">"); 
1 0 break; 

case '<': 
sb.append("<"); 
break; 
case '&': 

1 5 sb.append("& n ); 

break; 
case "": 
sb.append("" u ); 
break; 

20 case V: 

sb.append("""); 
break; 
default: 

if (Character.isDefined(c[x])) 
25 sb.append(c[x]); 

} 

} 

return sb.toString(); 

} 

3 0 public void setStreet(String inp) { 

this.mStreet = inp; 

} 

public void streetF romXML(String n){ 
setStreet(n); 

35 } 

public String getCity(){ 
return mCity; 

} 

public String getCityToXML(){ 
40 if (getCity() = null) return null; 

char [] c = getCity().toCharArray(); 
StringBuffer sb = new StringBuffer(); 
for (int x = 0; x < c.length; x++){ 
switch(c[x]){ 
45 case '>': 

sb.append(">"); 
break; 
case '<': 
sb.append( M < M ); 
50 break; 
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case '&': 
sb . append( ' ' &amp ; ") ; 
break; 

case "": 

5 sb.append("""); 

break; 
case V: 
sb.append( M " "); 
break; 

10 default: 

if (Character.isDefined(c[x])) 
sb.append(c[x]); 

} 

} 

1 5 return sb.toString(); 

} 

public void setCity(String inp){ 
this.mCity = inp; 

} 

20 public void cityFrornXML(String n) { 

setCity(n); 

} 

public int getState(){ 
return mState; 

25 } 

public String getStateToXML() { 
switch (mState){ 

case AK: return "AK"; 
case AL: return "AL"; 
30 case AR: return "AR"; 

case AZ: return "AZ"; 



} 

35 return null; 

} 

public void setState(int inp) { 
this.mState = inp; 

} 

40 public void stateFromXML(String s){ 

if (s.equals("AK")) mState - AK; 
else if (s.equals("AL"))mState = AL; 
else if (s.equals( n AR"))mState - AR; 
else if (s.equals( M AZ"))mState = AZ; 

45 

} 

public String getPostcode() { 
return mPostcode; 

50 } 
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public String getPostcodeToXML(){ 

if (getPostcode() = null) return null; 
char [] c = getPostcode().toChar Array (); 
StringBuffer sb = new StringBuffer(); 
5 for (int x = 0; x < c.length; x++) { 

switch(c[x]){ 
case '>': 
sb.append(">"); 
break; 

10 case'<' : 

sb.append("< M ); 

break; 
case '&': 

sb.append("&"); 
15 break; 

case "": 

sb.append("""); 

break; 
case V: 

20 sb.append("""); 

break; 
default: 
if (Character.isDefined(c[x])) 
sb.append(c[x]); 

25 } 

} 

return sb.toString(); 

} 

public void setPostcode(String inp) { 
30 this.mPostcode = inp; 

} 

public void postcodeFromXML(String n){ 
setPostcode(n); 

} 

3 5 public int getCountry () { 

return mCountry; 

} 

public String getCounrryToXML(){ 
switch (mCountry) { 
40 case AD : return "AD" ; 

case AE: return "AE"; 
case AF: return "AF"; 



45 } 

return null; 

} 

public void setCountry(int inp){ 
this. mCountry = inp; 

50 } 
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public void countryFromXML(String s){ 

if (s.equals( f, AD ,f )) mCountry - AD; 
else if (s.equals("AE"))mCoitntry - AE; 
else if (s.equals("AF"))mCountry = AF; 
5 else if (s.equalsCAG n ))mCountry = AG; 

else if (s.equals("AI M ))mCountry = AI; 



} 

10 } 



package com.veo.xdk.dev.schema.test.blib; 



import com.veo.vsp.doclet.meta.Document; 
1 5 public class AddressSet extends Document { 

public static final String DOC TYPE = "address. set"; 
AddressPhysical mAddressPhysical; 
String [] mTelephone; 
String [] mFax; 
20 String [] mEmail; 

String [] mlnternet; 
public AddressSet(){ 

super(DOC_TYPE); 

tMs.mAddressPhysical = new AddressPhysical(); 
25 mTelephone = null; 

mFax = null; 
mEmail = null; 
mlnternet = null; 

} 

3 0 public AddressSet(String docjype) { 

super(doc_type); 

this.mAddressPhysical = new AddressPhysical(); 
mTelephone = null; 
mFax = null; 
35 mEmail = null; 

mlnternet = null; 
} 

static public AddressSet initAddressSet(AddressPhysical iAddressPhysical, String [] 
iTelephone,String [] iFax,String [] iEmail,String [] ilnternet){ 
40 AddressSet obj = new AddressSet(); 

obj\initializeAll(iAddressPhysical, iTelephone, iFax, iEmail, ilnternet); 
return obj; 

} 

45 public void initializeAll(AddressPhysical iAddressPhysical,String [] iTelephone, String 

[] iFax,String [] iEmail,String [] ilnternet) { 

mAddressPhysical = iAddressPhysical; 

mTelephone = iTelephone; 

mFax = iFax; 
5 0 mEmail = iEmail; 
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mlnternet = ilnternet; 

} 

public AddressPhysical getAddressPhysical() { 
return mAddressPhysical; 

5 } 

public void setAddressPhysical( AddressPhysical inp){ 
tnis.mAddressPhysical = inp; 

} 

public String [] getTelephone(){ 
1 0 return mTelephone; 

} 

public String getTelephone(int index) { 
if (this.mTelephone = null) 
return null; 

15 if (index >= this.mTelephone.length) 

return null; 

if (index < 0 && -index > this.mTelephone.length) 
return null; 

if (index >= 0) return this. mTelephone [index]; 
20 return this.mTelephone[this.mTelephone.length + index]; 

} 

public String [] getTelephoneToXML() { 

String [] valArr = getTelephone(); 
if (valArr = null) return null; 
25 String [] nvArr = new String[valArr.length]; 

for (int z = 0; z < nvArr.length; z++) { 
char [] c = valArr[z].toCharArrayO; 
StringBuffer st - new StringBuffer(); 
StringBuffer sb = new StringBuffer(); 
3 0 for (int x = 0; x < c.length; x++) { 

switch(c[x]){ 
case '>': 
sb.append(">"); 
break; 

35 case'<': 

sb.appendC'<"); 

break; 
case '&': 

sb. append( " &amp ; ") ; 
40 break; 

case "": 

sb.append("""); 

break; 
case '": 

45 sb.append( M " M ); 

break; 
default: 
if (Character.isDefined(c[x])) 
sb.append(c[x]); 

50 } 



-55- 



Atty Docket No.: 19957-701 
H:\PRIVATE\CLIENT\19957CN0WEOAPP.001 



} 

nvArrfz] = sb.toString(); 

} 

return nvArr; 

5 } 

public void setTelephone(int index, String inp){ 
if (this .mTelephone = null) { 
if (index <0) { 
this. mTelephone = new String[l]; 
1 0 this.mTelephone[0] = inp; 

} else { 

ttas.mTelephone = new String[index + 1]; 
this.mTelephone[index] = inp; 

} 

15 } else if (index < 0) { 

String [] newTelephone = new Strnig[this.mTelephone.length + 1]; 
java.lang.System.arraycopy((Object)mTelephone 3 0, 
(Object)newTelephone, 0, this.mTelephone.length); 

newTelephonefnewTelephone.length - 1] = inp; 
20 mTelephone = newTelephone; 

} else if (index >= this.mTelephone.length) { 

String [] newTelephone = new String [index + 1]; 
java.lang.System.arraycopy((Object)mTelephone, 0, 
(Object)newTelephone, 0, this.mTelephone.length); 
25 newTelephone [index] = inp; 

mTelephone = newTelephone; 

} else { 

this.mTelephone[index] = inp; 

} 

30 } 

public void setTelephone(String [] inp){ 
this.mTelephone = inp; 

} 

public void telephoneFromXML(String n){ 
3 5 setTelephone(- 1 , n); 

public String [] getFax(){ 
return mFax; 

} 

40 public String getFax(int index) { 

if (this. mFax = null) 

return null; 
if (index >= this.mFax.length) 
return null; 

45 if (index < 0 && -index > this.mFax.length) 

return null; 
if (index >= 0) return this.mFax[index]; 
return mis.mFax[this.mFax.length + index]; 

} 

50 public String [] getFaxToXMLQ { 
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String [] valArr = getFax(); 
if (valArr = null) return null; 
String [] nvArr = new String[valArr.length]; 
for (int z = 0; z < nvArr.length; z++) { 
5 char [] c = valArr[z].toCharArray(); 

StringBuffer st = new StringBuffer(); 
StringBuffer sb = new StringBuffer(); 
for (int x = 0; x < c.length; x++){ 
switch(c[x]){ 
10 case'>': 

sb.append(">"); 
break; 
case '<': 
sb.append("<"); 
1 5 break; 

case 

sb.append("& M ); 
break; 
case "": 

20 sb.append( n ""); 

break; 
case ,n : 
sb.append("" n ); 
break; 

25 default: 

if (Character. isDefined(c[x])) 
sb.append(c[x]); 

} 

} 

30 nvArr[z] = sb.toString(); 

} 

return nvArr; 

} 

public void setFax(int index, String inp){ 
35 if (ttas.mFax = null) { 

if (index < 0) { 
this.mFax = new String[l]; 
this.mFax[0] = inp; 
} else { 

40 this.mFax = new String[index + 1 ] ; 

this.rnFax[index] = inp; 

} 

} else if (index < 0) { 

String [] newFax = new String [this .mFax.length +1]; 
45 java.lang.System.arraycopy((Object)mFax 5 0, (Object)newFax, 0, 

this.mFax.length); 

newFax[newFax.length - 1] = inp; 
mFax — newFax; 
} else if (index >= this . mFax.length) { 
50 String [] newFax = new String[index + 1]; 
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java.lang.System.arraycopy((Object)mFax ? 0, (Object)newFax, 0, 

this.rnFax.length); 

newFaxpndex] = inp; 
mFax = newFax; 

5 } else { 

this.mFax[index] = inp; 

} 

} 

public void setFax(String [] inp){ 
10 this. mFax = inp; 

} 

public void faxFromXML(String n){ 
setFax(-l, n); 

} 

1 5 public String [] getEmail() { 

return mEmail; 

public String getEmail(int index) { 
if (this.mEmail = null) 
20 return null; 

if (index >= this.mEmail.length) 
return null; 

if (index < 0 && -index > this.rnErnaiLlengtri) 
return null; 

25 if (index >= 0) return this.mEmail[index]; 

return this.rriErrmil[this.rriErnailJength + index]; 

} 

public String [] getEmailToXML() { 

String [] valArr = getEmail(); 
30 if (valArr = null) return null; 

String [] nvArr = new String [valArr.length]; 
for (int z = 0; z < nvArr.length; z++) { 
char [] c = valArr [z].toCharArray(); 
StringBuffer st = new SrringBuffer(); 
3 5 StringBuffer sb = new StringBuffer(); 

for (int x = 0; x < c.length; x++) { 
switch(c[x]){ 
case r > T : 
sb.appendC'>"); 
40 break; 

case '<': 
sb.append( ,! < n ); 
break; 
case 

45 sb.append("&"); 

break; 
case M ": 
sb.append( M ""); 
break; 

50 case m : 
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sb. append( "" ") ; 

break; 
default: 

if (Character.isDefined(c[x])) 
5 sb.append(c[x]); 

} 

} 

nvArr[z] = sb.toString(); 

} 

1 0 return nvArr; 

} 

public void setEmail(int index, String inp) { 
if (this.mEmail = null) { 
if (index < 0) { 

1 5 this.mEmail = new String[l]; 

this.mEmail[0] = inp; 
} else { 

this.mEmail = new String [index +1]; 
this.rnEmailfindex] = inp; 

20 } 

} else if (index < 0) { 

String [] newEmail = new Strmg[trns.rnEmail.length +1]; 
java.lang.System.arraycopy((Object)mEmail ? 0, (Object)newEmail, 

0, this.mEmail.length); 
25 newEmail[newEmaiLlength - 1] = inp; 

mEmail = newEmail; 
} else if (index >= this.mEmail.length) { 

String [] newEmail = new String [index +1]; 

java.lang.System.arraycopy((Object)mEmail ? 0, (Object)newEmail ? 

30 0, this.mEmail.lengtb); 

newEmailfindex] = inp; 
mEmail = newEmail; 

} else { 

this.mEmail[index] — inp; 

35 } 
} 

public void setEmail(String [] inp){ 
this.mEmail = inp; 

} 

40 public void emailFromXML(String n) { 

setEmail(-l, n); 

} 

public String [] getlnternet(){ 
return rnlnternet; 

45 } 

public String getlnternet(int index) { 
if (this .rnlnternet = null) 

return null; 
if (index >= this.mlnternet.length) 
50 return null; 
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if (index < 0 && -index > this.mlnternet.length) 

return null; 
if (index >= 0) return tMs.rnInternet[index]; 
return tMs.rnIntemet[Ms.rnInternet length + index]; 

5 } 

public String [] getInternetToXML() { 

String [] valArr = getlnternet(); 
if (valArr = null) return null; 
String [] nvArr = new String[valArr.length]; 
10 for (int z = 0; z < nvArr. length; z++) { 

char [] c = valArr[z].toCharArray(); 
StringBuffer st = new StringBuffer(); 
StringBuffer sb = new StringBuffer(); 
for (int x = 0; x < c.length; x++){ 
15 switch(c[x]){ 

case '>': 
sb.append(">"); 
break; 
case '<': 

20 sb.append("<"); 

break; 
case '&': 
sb.append("&"); 
break; 

25 case'"': 

sb.append(""") ; 
break; 
case "': 
sb.append("""); 
30 break; 

default: 
if (Character.isDefined(c[x])) 
sb.append(c[x]); 

} 

35 } 

nvArr[z] = sb.toString(); 

} 

return nvArr; 

40 public void setlnternet(int index, String inp) { 

if (this.mlnternet == null) { 
if (index <0) { 
this.mlnternet = new String[l]; 
tMs.rnInternet[0] = inp; 
45 } else { 

this.mlnternet = new Stringpndex + 1]; 
this.mlnternet[index] = inp; 

} 

} else if (index <0) { 

50 String [] newlnternet = new String [this.mlnternet.length + 1] 
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javaJang.System.arraycopy((Object)mInternet, 0, 
(Object)newInternet, 0, this.mlnternet.length); 

newlnternet[newlnternet.length - 1] = inp; 
mlnternet = newlntemet; 
5 } else if (index >= this.mlnternet.length) { 

String [] newlntemet = new String[index + i]; 
j ava.lang . Sy stem.arraycopy ((Obj ect)mlnternet, 0, 
(Object)newInternet, 0, this.mlnternet.length); 

newlnternet[index] = inp; 
1 0 mlnternet = newlntemet; 

} else { 

this.mlnternet[index] — inp; 

} 

} 

1 5 public void setInternet(String [] inp) { 

this.mlnteniet = inp; 

} 

public void internetFromXML(String n){ 
setlnternet(-l, n); 

20 } 

} 

package com. veo.xdk. dev. schema. test. b lib; 

25 import com.veo.vsp.docletmeta.Document; 

public class Business extends Party { 

public static final String DOCJTYPE = "business"; 

String aBusinessNumber; 

public Business() { 
30 super(DOC_TYPE); 

aBusinessNumber = new StringO; 

} 

public Business(String doc_type) { 
super(doctype) ; 
3 5 aBusinessNumber = new StringO ; 

} 

static public Business initBusiness(String iBusinessNumber, String [] 
iPartyName ? AddressSet iAddressSet){ 

Business obj = new Business(); 
40 obj.initializeAll(iBusinessNumber, iPartyName, iAddressSet); 

return obj; 

} 

public void imtializeAll(String iBusinessNumber,String [] iPartyNameAddressSet 
45 iAddressSet) { 

aBusinessNumber = iBusinessNumber; 
super.initializeAll(iPartyName ? iAddressSet); 

} 

public String getBusinessNumber() { 
50 return aBusinessNumber; 
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} 

public String getBusinessNumberToXML() { 

if (getBusinessNumber() = null) return null; 
char [] c = getBusinessNumber().toCharArray(); 
5 StringBuffer sb = new StringBuffer(); 

for (int x = 0; x < c.length; x++){ 
switch(c[x]){ 
case '> T : 
sb.append("> M ); 
1 0 break; 

case '<': 
sb.append("<"); 
break; 
case '&': 

1 5 sb.append("& n ); 

break; 
case "": 
sb.append("""); 
break; 

20 caseV: 

sb.append( M " n ); 
break; 
default: 
if (Character.isDefined(c[x])) 
25 sb.append(c[x]); 

} 

} 

return sb.toString(); 

} 

3 0 public void setBusinessNumber(String inp) { 

this.aBusinessNumber = inp; 

} 

public void businessNumberFroniXML(String n){ 
setBusinessNumber(n) ; 

35 } 



import com.veo.vsp.docletmeta.Document; 
40 public class Party extends Document { 

public static final String DOCTYPE = "party"; 
String [] mPartyNarne; 
AddressSet mAddressSet; 
public Party(){ 
45 super(DOC_TYPE); 

mPartyNarne = new String[0]; 

this.mAddressSet = new AddressSet(); 

} 

public Party(String doc_type){ 
50 super(doc type); 
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mPartyName = new String[0]; 

this.mAddressSet = new AddressSet(); 

static public Party initParty(String [] iPartyName,Ad<fressSet iAddressSet) { 
Party obj = new Party(); 
obj.initializeAll(iPartyName, iAddressSet); 
return obj; 

} 

public void initializeAll(String [] iPartyName,AddressSet iAddressSet) { 
mPartyName = iPartyName; 
mAddressSet = iAddressSet; 

} 

public String [] getPartyName(){ 
return mPartyName; 

} 

public String getPartyName(int index) { 
if (this.mPartyNarne = null) 
return null; 
if (index >= this.rnPartyName.length) 
return null; 

if (index < 0 && -index > this.rnPartyName.length) 
return null; 

if (index >= 0) return this .mPartyName [index]; 

return this.mPartyName[mis.mPartyName.length + index]; 

} 

public String [] getPartyNameToXML() { 

String [] valArr = getPartyName(); 
if (valArr = null) return null; 
String [] nvArr = new String [valArr.length]; 
for (int z = 0; z < nvArr.length; z++) { 
char [] c = valArr [z].toCharArray(); 
StringBuffer st = new StringBuffer(); 
StringBuffer sb = new StringBuffer(); 
for (int x = 0; x < c.length; x++) { 
switch(c[x]){ 
case *> f : 
sb.append( M > n ); 
break; 
case '<': 
sb.append( M <"); 
break; 
case 

sb.append( n &"); 

break; 
case "": 

sb.append("""); 

break; 
case m : 

sb.appendC'""); 
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break; 
default: 
if (CharacterisDefined(c[x])) 
sb.append(c[x]); 

5 } 

} 

nvArr[z] = sb.toString(); 

} 

return nvArr; 

10 } 

public void setPartyName(int index, String inp){ 
if (this .mPartyName = null) { 
if (index <0) { 
this.mPartyName = new String[l]; 
1 5 this.mPartyName[0] = inp; 

} else { 

this.mPartyName = new String[index + 1]; 
this.rnPartyName[index] = inp; 

} 

20 } else if (index <0) { 

String [] newPartyName = new Strmg[mis.rriPartyNarne.length + 1]; 
javaJang.Systern.arraycopy((Object)mPartyNarne, 0, 
(Object)newPartyName 5 0, this.mPartyName.length); 

newPartyName[newPartyName.length - 1] = inp; 
25 mPartyName = newPartyName; 

} else if (index >= this.mPartyName.length) { 

String [] newPartyName = new String[index +1]; 
java.lang.System.arraycopy((Object)mPartyName J 0, 
(Object)newPartyName, 0, this.mPartyName.length); 
3 0 newPartyName [index] = inp ; 

mPartyName = newPartyName; 

} else { 

this . mP artyName [index] = inp; 

} 

35 } 

public void setPartyName(String [] inp){ 
this.mPartyName = inp; 

} 

public void par1yNameFromXML(String n){ 
40 setPartyName(- 1 , n); 

} 

public AddressSet getAddressSet(){ 
return mAddressSet; 

} 

45 public void setAddressSet(AddressSet inp) { 

this .mAddressSet = inp; 

} 

50 package com.veo.xdk.dev.schema.test.blib; 
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import com. veo . vsp .doclet .meta.Document; 
public class Person extends Party { 

public static final String DOC_TYPE - "person"; 
String aSSN; 
5 public Person(){ 

super(DOC_TYPE); 
aSSN = null; 
} 

public Person(String doc_type){ 
10 super(doc_type); 

aSSN = null; 
} 

static public Person initPerson(String iSSN,String [] iPartyName,A<i<fressSet 
iAddressSet){ 

1 5 Person obj = new Person(); 

obj.initializeAll(iSSN, iPartyName, iAddressSet); 
return obj; 

} 

20 public void initializeAll(String iSSN,String [] iPartyName ? AddressSet iAddressSet) { 

aSSN = iSSN; 

super. initialize All(iPartyName ? iAddressSet) ; 

} 

public String getSSN(){ 
25 return aSSN; 

} 

public String getSSNToXML(){ 

if (getSSN() = null) return null; 
char [] c = g etSSN().toCharArray(); 
3 0 StringBuffer sb = new StringBuffer(); 

for (int x = 0; x < c.length; x++) { 
switch(c[x]){ 
case '>': 
sb.append(">"); 
35 break; 

case *<': 
sb.append("<"); 
break; 
case '&': 

40 sb.append("&"); 

break; 
case ,m : 
sb.append("" n ); 
break; 

45 case V: 

sb.append("" ") ; 

break; 
default: 

if (Character.isDefined(c[x])) 
50 sb.append(c[x]); 
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} 

} 

return sb.toString(); 

} 

5 public void setSSN(String inp){ 

this.aSSN = inp; 

} 

public void sSNFromXML(String n) { 
setSSN(n); 

10 } 

} 

package com.veo.xdk.dev. schema. test.blib; 

1 5 import com.veo.vsp.doclet.meta.Document; 

public class PrototypeService extends Document { 

public static final String DOC TYPE = "prototype.service"; 
String mServiceName; 
String [] mServiceTerms; 
20 String [] mServiceLocation; 

ServiceOperation [] mServiceOperation; 
public PrototypeService(){ 

super(DOC_TYPE); 
mServiceName = new String(); 
25 mServiceTerms = new String[0] ; 

mServiceLocation = new StringfO]; 

this.mServiceOperation = new ServiceOperation[0]; 

} 

public PrototypeService(String doc_type){ 
30 super(doctype); 

mServiceName = new String(); 
mServiceTerms = new String[0]; 
mServiceLocation = new String [0]; 

this.mServiceOperation — new ServiceOperation[0]; 

35 } 

static public PrototypeService initPrototypeService(String iServiceName, String [] 
iServiceTerms ? String [] iServiceLocation,ServiceOperation [] iServiceOperation){ 
PrototypeService obj = new PrototypeService(); 
obj.initializeAll(iServiceName ; iServiceTerms, iServiceLocation, 
40 iServiceOperation); 

return obj; 

} 

public void initializeAll(String iSei^iceName^String [] iServiceTerms ? String [] 
45 iServiceLocation 3 ServiceOperation [] iServiceOperation) { 

mServiceName = iServiceName; 
mServiceTerms = iServiceTerms; 
mServiceLocation = iServiceLocation; 
mServiceOperation = iServiceOperation; 

50 } 
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public String getServiceName(){ 
return mServiceName; 

} 

public String getServiceNameToXML() { 
5 if (getServiceName() = null) return null; 

char [] c = getServiceName().toChar Array (); 
StringBuffer sb = new StringBuffer(); 
for (int x = 0; x < c.length; x++){ 
switch(c[x]){ 
10 case*>': 

sb.append(">"); 
break; 
case '<': 
sb.append("< ,r ); 
15 break; 

case '&': 
sb.append( n &"); 
break; 
case "": 

20 sb.append("""); 

break; 
case V: 
sb.append("""); 
break; 

25 default: 

if (Character.isDefined(c[x])) 
sb.append(c[x]); 

} 

} 

30 return sb.toString(); 

} 

public void setServiceName(String inp){ 
this.mServiceName = inp; 

} 

35 public void serriceNameFrorriXML(Strmg n){ 

setServiceName(n) ; 

} 

public String [] getServiceTerms(){ 
return mServiceTerms; 

40 } 

public String getServiceTerms(int index) { 
if (this.mServiceTerms = null) 
return null; 
if (index this. mServiceTerms. length) 
45 return null; 

if (index < 0 && -index > this.rnServiceTerms.length) 
return null; 

if (index >= 0) return this.mServiceTerms [index]; 

return mis .mServiceTerms [mis .mServiceTerms. length + index] 

50 } 
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public String [] getServiceTermsToXML() { 

String [] valArr = getServiceTerms(); 
if (valArr = null) return null; 
String [] nvArr = new String[valArr. length]; 
5 for (int z = 0; z < nvArr.length; z++) { 

char [] c = valArr[z] .toChar Array (); 
StringBuffer st = new StringBuffer(); 
StringBuffer sb = new StringBuffer(); 
for (int x = 0; x < c.length; x++){ 
10 switch(c[x]){ 

case '>': 
sb.append(">"); 
break; 
case '<*: 

15 sb.append("< n ); 

break; 
case '&': 
sb.append( "& ") ; 
break; 

20 case "": 

sb .append("" "); 
break; 
case m : 
sb.appendC'""); 
25 break; 

default: 
if (Character isDefmed(c[x])) 
sb.append(c[x]); 

} 

30 } 

nvArr[z] = sb.toString(); 

} 

return nvArr; 

} 

3 5 public void setServiceTerms(int index, String inp) { 

if (this.mServiceTerms = null) { 
if (index <0) { 
this.mServiceTerms = new String[l]; 
this.mServiceTerms[0] = inp; 
40 } else { 

this.mServiceTerms = new String[index +1]; 
this.mServiceTerms[index] = inp; 

} 

} else if (index <0) { 

45 String [] newServiceTerms = new String[tMs.rnServiceTennsdength 

javaJang.System.arTaycopy((Object)mServiceTerrns ? 0, 
(Object)newServiceTerms, 0, tMs.mServiceTerms.length); 

newServiceTerms[newServiceTerms.length - 1] = inp; 
50 mServiceTerms = newServiceTerms; 
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} else if (index >= this.mServiceTerms.length) { 

String [] newServiceTerms = new Stringfindex +1]; 
java.lang.System.arraycopy^Objec^mServiceTermSj 0, 
(Object)newServiceTerms, 0, this.mServiceTerms.length); 
5 newServiceTerms[index] = inp; 

mServiceTerms = newServiceTerms; 

} else { 

this.mServiceTerms[index] = inp; 

> 

10 } 

public void setServiceTerms(String [] inp){ 
this.mServiceTerms = inp; 

} 

public void serviceTemsFromXML(String n){ 
1 5 setServiceTerms(- 1 , n); 

} 

public String [] getServiceLocation() { 
return mServiceLocation; 

} 

20 public String getServiceLocation(int index) { 

if (this .mServiceLocation = null) 

return null; 
if (index >= this.mServiceLocation.length) 
return null; 

25 if (index < 0 && -index > this.mServiceLocation.length) 

return null; 

if (index >= 0) return this.mServiceLocationfindex]; 

return this.mServiceLocation[this.mServiceLocation.length + index]; 

} 

30 public String [] getServiceLocationToXML() { 

String [] valArr = getServiceLocation(); 
if (valArr = null) return null; 
String [] nvArr ~ new String[valArr. length]; 
for (int z = 0; z < nvArr.length; z++){ 
3 5 char [] c = valArr [z] .toChar Array () ; 

StringBuffer st = new StringBuffer(); 
StringBuffer sb = new StringBuffer(); 
for (int x = 0; x < c.length; x++){ 
switch(c[x]){ 
40 case *>': 

sb.append( M >"); 
break; 
case '<*: 
sb.appendC'<"); 
45 break; 

case 

sb.append("&"); 
break; 
case "": 

5 0 sb .append( M " ff ) ; 
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break; 
case '": 
sb.appendO'"") ; 
break; 

5 default: 

if (Character.isDefined(c[x])) 
sb . append(c [x] ) ; 

} 

} 

1 0 nvArr[z] = sb. toString() ; 

} 

return nvArr; 

} 

public void setServiceLocation(int index, String inp){ 
15 if (this.mServiceLocation = null) { 

if (index <0) { 
this.mServiceLocation = new String[l]; 
this.mServiceLocation[0] = inp; 
} else { 

20 this.mServiceLocation = new String [index +1]; 

this.mServiceLocation[index] = inp; 

} 

} else if (index < 0) { 

String [] newServiceLocation = new 
25 String[this.mServiceLocation.length+ 1]; 

java.lang.System.arraycopy((Object)mServiceLocation, 0, 
(Object)newServiceLocation, 0, this.mServiceLocation. length); 

newServiceLocation[newServiceLocation.length - 1] = inp; 
mServiceLocation = newServiceLocation; 
30 } else if (index >= this.mServiceLocation.length){ 

String [] newServiceLocation = new String[index +1]; 
java.lang.System.arraycopy((Object)mServiceLocation, 0, 
(Object)newServiceLocation ? 0, this.mServiceLocation.length); 

newServiceLocation[index] = inp; 
3 5 mServiceLocation = newServiceLocation; 

} else { 

this.mServiceLocation[index] = inp; 

} 

} 

40 public void setServiceLocation(String [] inp) { 

this.mServiceLocation = inp; 

} 

public void serviceLocatioriFrornXML(String n){ 
setServiceLocation(-l, n); 

45 } 

public ServiceOperation [] getServiceOperationO { 
return mServiceOperation; 

} 

public ServiceOperation getServiceOperation(int index) { 
50 if (this .mServiceOperation = null) 
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return null; 
if (index >= this.mServiceOperation.length) 
return null; 

if (index < 0 && -index > this.mServiceOperation.length) 
5 return null; 

if (index >= 0) return this.mServiceOperation[index]; 

return this,mServiceOperation[trns.mServiceOperation.length + index]; 

} 

public void setServiceOperation(int index, ServiceOperation inp){ 
10 if (this.mServiceOperation = null) { 

if(index<0) { 
this.mServiceOperation = new ServiceOperation[l]; 
this.mServiceOperation[0] = inp; 
} else { 

1 5 this.mServiceOperation = new ServiceOperarionpndex + 1 ]; 

this.mServiceOperation[index] = inp; 

} 

} else if (index < 0) { 

ServiceOperation [] newServiceOperation = new 
20 ServiceOperation[this .mServiceOperation. length + 1]; 

j ava.lang. System, array copy ((Object)mServiceOperation, 0, 
(Object)newServiceOperation, 0, this.mServiceOperation.length); 

newServiceOperation[newServiceOperation. length - i] ^inp; 
mServiceOperation = newServiceOperation; 
25 } else if (index >= this.mServiceOperation.length) { 

ServiceOperation [] newServiceOperation = new 
ServiceOperation[index +1]; 

j ava.lang. Sy stenxarray copy ((Obj ect)mServiceOperation, 0, 
(Object)newServiceOperation ? 0, this.mServiceOperation.length); 
30 newServiceOperation[index] = inp; 

mServiceOperation = newServiceOperation; 

} else { 

this.mServiceOperation[index] = inp; 

} 

35 } 

public void setServiceOperarion(ServiceOperation [] inp) { 
this.mServiceOperation = inp; 

} 

} 



40 



package com.veo.xdk.dev.schema.test.blib; 



import com. veo . vsp .doclet .meta.Document; 
public class Service extends Document { 
45 public static final String DOC_TYPE = "service"; 

String mServiceName; 
String mServiceLocation; 
ServiceOperation [] mServiceOperation; 
String mServiceTerms; 
50 public Service(){ 
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super(DOC_TYPE); 
mServiceName = new String(); 
mServiceLocation = new String(); 

ttas.mServiceOperation = new ServiceOperation[0]; 
5 mServiceTerms = new String(); 

} 

public Service(String doc_type){ 

super(doc_type) ; 
mServiceName = new String(); 
1 0 mServiceLocation = new String(); 

this.mServiceOperation = new ServiceOperation[0]; 
mServiceTerms = new String(); 
} 

static public Service initService(String iServiceName ? String 
1 5 iServiceLocation,ServiceOperation [] iServiceOperation, String iServiceTerms) { 

Service obj = new Service(); 

obj. initialize All(iServiceName ? iServiceLocation, iServiceOperation, 

iServiceTerms); 

return obj; 

20 } 

public void mitializeAll(String iServiceName, String 
iServiceLocation ? ServiceOperation [] iServiceOperation,String iServiceTerms) { 
mServiceName = iServiceName; 
25 mServiceLocation = iServiceLocation; 

mServiceOperation = iServiceOperation; 
mServiceTerms = iServiceTerms; 

} 

public String getServiceName() { 
30 return mServiceName; 

} 

public String getServiceNameToXML(){ 

if (getServiceName() = null) return null; 
char [] c = getServiceName().toCharArray(); 
3 5 StringBuffer sb = new StringBuffer(); 

for (int x = 0; x < c.length; x++) { 
switch(c[x]){ 
case '>': 
sb.append( H >"); 
40 break; 

case '<?: 
sb.append( n < M ); 
break; 
case 

45 sb.append("&"); 

break; 
case "": 
sb,append("""); 
break; 

50 case X: 
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sb.append( n ""); 
break; 
default: 
if (Character.isDefined(c[x])) 
5 sb.append(c[x]); 

} 

} 

return sb.toString(); 

} 

1 0 public void setServiceName(String inp) { 

this.mServiceName = inp; 

} 

public void serviceNameFromXML(String n){ 
setServiceName(n); 

15 } 

public String getServiceLocation(){ 
return mServiceLocation; 

} 

public String getServiceLocationToXML() { 
20 if (getServiceLocation() = null) return null; 

char [] c = getServiceLocation().toCharArray(); 
StringBuffer sb = new StringBuffer(); 
for (int x - 0; x < c.length; x++){ 
switch(c[x]){ 
25 case '>': 

sb.append(">"); 
break; 
case T <': 
sb.append("<"); 
30 break; 

case '& r : 
sb . append( " &amp ; ") ; 
break; 
case "": 

35 sb.append( M " n ); 

break; 
case X: 
sb.append(""") ; 
break; 

40 default: 

if (Character.isDefined(c[x])) 
sb.append(c[x]); 

} 

} 

45 return sb.toString(); 

} 

public void setServiceLocation(String inp){ 
this. mServiceLocation — inp; 

} 

5 0 public void serviceLocationFromXML(String n) { 
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setServiceLocation(n); 

} 

public ServiceOperation [] getServiceOperation(){ 
return mServiceOperation; 

5 } 

public ServiceOperation getServiceOperation(int index) { 
if (this.mServiceOperation = null) 
return null; 
if (index >= this.mServiceOperation. length) 
10 return null; 

if (index < 0 && -index > this.mServiceOperation.length) 
return null; 

if (index >= 0) return this.mServiceOperation[index]; 

return tMs.mSei^iceOperation[this.mServiceOperation.length + index]; 

15 } 

public void setServiceOperation(int index, ServiceOperation inp){ 
if (this.mServiceOperation = null) { 
if(index<0) { 
this.mServiceOperation = new ServiceOperation[l]; 
20 this.mServiceOperation[0] = inp; 

} else { 

this.mServiceOperation = new ServiceOperationfindex +1]; 
this.mServiceOperation[index] = inp; 

} 

25 } else if (index < 0) { 

ServiceOperation [] newServiceOperation = new 
ServiceOperationfthis.mServiceOperation.length +1]; 

java.lang.System.arraycopy((Object)mServiceOperation ? 0, 
(Object)newServiceOperation, 0, this.mServiceOperation.lengtii); 
30 newServiceOperation[newServiceOperation.length - 1] = inp; 

mServiceOperation = newServiceOperation; 
} else if (index >= this.mServiceOperation.length){ 

ServiceOperation [] newServiceOperation = new 
ServiceOperation[index +1]; 
35 java.lang.System.arraycopy((Object)mServiceOperation, 0, 

(Object)newServiceOperation, 0, this.mServiceOperation.length); 

newServiceOperation[index] = inp; 
mServiceOperation = newServiceOperation; 

} else { 

40 this.mServiceOperation[index] = inp; 

} 

} 

public void setServiceOperation(ServiceOperation [] inp){ 
this.mServiceOperation = inp; 

45 } 

public String getServiceTerms() { 
return mServiceTerms; 

} 

public String getServiceTermsToXML() { 
50 if (getServiceTerms() = null) return null; 
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char [] c = getServiceTerms().toCharArray(); 
StringBuffer sb = new StringBuffer(); 
for (int x = 0; x < c.length; x++) { 
switch(c[x]){ 
5 caseV; 

sb.appendf>"); 
break; 
case '< f : 
sb.append("<"); 
10 break; 

case '& f : 
sb.append("&"); 
break; 
case "": 

15 sb.appendC'""); 

break; 
case V: 
sb.append("""); 
break; 

20 default: 

if (Character isDefmed(c[x])) 
sb.append(c[x]); 

} 

> 

25 return sb.toString(); 

} 

public void setServiceTerms(String inp){ 
this.rriServiceTerms = inp; 

} 

3 0 public void sereiceTeimsFromXML(String n) { 

setServiceTerms(n) ; 

} 

} 

35 package com. veo.xdk.de v. schema. testblib; 

import com.veo.vsp.docletmeta.Document; 
public class ServiceOperation extends Document { 

public static final String DOCJTYPE = "service.operation" 
40 String mServiceOperationName; 

String mServiceOperationLocation; 
String mServiceOperationlnput; 
String mServiceOperationOutput; 
public ServiceOperation(){ 
45 super(DOC_TYPE); 

mServiceOperationName = new String(); 
mServiceOperationLocation = new String(); 
mServiceOperationlnput = new String(); 
mServiceOperationOutput = new String(); 
50 } 
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public ServiceOperation( String doc type) { 

super(doc_type) ; 
mServiceOperationName = new String(); 
mServiceOperationLocation = new String(); , 
5 mServiceOperationlnput = new String(); 

mServiceOperationOutput = new String(); 
} 

static public ServiceOperation initServiceOperation(String 
iServiceOperationName ? String iServiceOperationLocation,String iServiceOperationlnput, String 
1 0 iServiceOperationOutput) { 

ServiceOperation obj = new ServiceOperation(); 
obj .initializeAil(iServiceOperationName ; iServiceOperationLocation, 
iServiceOperationlnput, iServiceOperationOutput) ; 
return obj; 

15 } 

public void MtializeAll(String iServiceOperationName, String 
iServiceOperationLocation, String iServiceOperationInput,String iServiceOperationOutput) { 
mServiceOperationName = iServiceOperationName; 
20 mServiceOperationLocation = iServiceOperationLocation; 

mServiceOperationlnput - iServiceOperationlnput; 
mServiceOperationOutput = iServiceOperationOutput; 

} 

public String getServiceOperationName(){ 
25 return mServiceOperationName; 

> 

public String getServiceOperationNameToXML(){ 

if (getServiceOperationName() = null) return null; 
char [] c = getServiceOperationName().toCharArray(); 
3 0 StringBuffer sb = new StringBuffer(); 

for (int x = 0; x < c.length; x-H-){ 
switch(c[x]){ 
case '>': 
sb.append(*'> M ); 
35 break; 

case '<': 
sb.append( n <"); 
break; 
case 

40 sb.append( M & H ); 

break; 
case "": 
sb.append(" "") ; 
break; 

45 case V : 

sb . append(" " ") ; 

break; 
default: 

if (Character.isDefmed(c[x])) 
50 sb . app end(c [x] ) ; 
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} 

} 

return sb.toString(); 

} 

5 public void setServiceOperationName(String inp) { 

this.mServiceOperationName = inp; 

} 

public void serviceC^erationNameFromXML(String n){ 
setServiceOperationName(n); 

10 } 

public String getServiceOperationLocation(){ 
return mServiceOperationLocation; 

} 

public String getServiceOperationLocationToXML(){ 
15 if (getServiceOperationLocation() = null) return null; 

char [] c = getServiceOperationLocation().toCharArray(); 
StringBuffer sb = new StringBuffer(); 
for (int x = 0; x < c.length; x++){ 
switch(c[x]){ 
20 case V: 

sb.append(">"); 
break; 
case '<': 
sb.append("<"); 
25 break; 

case 

sb.append( M &"); 
break; 
case "": 

30 sb . append("" ") ; 

break; 
case V: 
sb.append("""); 
break; 

35 default: 

if (Character. isDefined(c[x])) 
sb.append(c[x]); 

} 

} 

40 return sb.toString(); 

} 

public void setServiceOperationLocation(String inp){ 
this.mServiceOperationLocation = inp; 

} 

45 public void serviceOperanonLocationFrorriXML(Strhig n) { 

setServiceOperationLocation(n); 

} 

public String getServiceOperationInput(){ 
return mServiceOperationlnput; 

50 } 
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public String getServiceOperationInputToXML() { 

if (getServiceOperationInput() = null) return null; 
char [] c = getServiceOperationInput().toCharArray(); 
StringBuffer sb = new StringBuffer(); 
5 for (int x = 0; x < c.length; x++) { 

switch(c[x]){ 
case '>': 
sb.append(">"); 
break; 

10 case'<': 

sb.append("< n ); 

break; 
case '&': 

sb.append("&"); 
15 break; 

case "": 

sb.append("""); 

break; 
case V: 

20 sb.append( n ""); 

break; 
default: 
if (Character isDefined(c[x])) 
sb.append(c[x]); 

25 } 

} 

return sb.toString(); 

} 

public void setServiceOperationInput(String inp){ 
30 this.mServiceOperationlnput = inp; 

} 

public void serviceOperationInputFrornXML(String n) { 
setServiceOperationInput(n) ; 

} 

35 public String getServiceOperationOutput() { 

return mServiceOperationOutput; 

} 

public String getServiceOperationOutputToXML(){ 

if (getServiceOperationOutput() = null) return null; 
40 char [] c = getServiceOperationOutput().toCharArray(); 

StringBuffer sb = new StringBuffer(); 
for (int x = 0; x < c.length; x++) { 
switch(c[x]){ 
case '>': 

45 sb.append(">"); 

break; 
case '<': 
sb.append("<"); 
break; 

50 case '&': 
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sb.append(" &amp ; ") ; 

break; 
case "": 

sb.append("""); 
5 break; 

case V: 

sb.append( M " n ); 

break; 
default: 

10 if (Character.isDefined(c [x] )) 

sb.append(c[x]); 

} 

} 

return sb.toString(); 

15 } 

public void setServiceOperationOutput(String inp){ 
this.mServiceOperationOutput — inp; 

} 

public void serviceOperationOutputFromXML(String n){ 
20 setSemceOperationOutput(n); 
} 

} 

package com.veo.xdk. dev. schema. test. blib; 

25 

import com.veo.vsp.doclet.meta.Document; 
public class ServiceSet extends Document { 

public static final String DOC_TYPE = "service.set"; 
Service [] mService; 
30 public ServiceSet(){ 

super(DOC_TYPE); 
this.mService = new Service [0]; 

} 

public ServiceSet(String doc_type){ 
3 5 super(doctype) ; 

this.mService = new Service[0]; 

static public ServiceSet initServiceSet(Service [] iService){ 
ServiceSet obj = new ServiceSet(); 
40 obj .initialize All(iService) ; 

return obj; 

public void initializeAll(Service [] iService){ 
45 mService = iService; 

} 

public Service [] getService(){ 
return mService; 

50 public Service getService(int index) { 
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if (this.mService = null) 

return null; 
if (index >= this.mService.length) 

return null; 

5 if (index < 0 && -index > this.mService.length) 

return null; 
if (index >= 0) return this.mService [index]; 
return this.mSei^ice[this.mService.length + index]; 

1 0 public void setService(int index, Service inp){ 

if (Ihis.mService — null) { 
if (index <0) { 
this.mService = new Service[l]; 
this.mService[0] = inp; 
15 }else{ 

this.mService = new Servicepndex +1]; 
this.mService [index] = inp; 

} 

} else if (index < 0) { 

20 Service [] newService = new Servicefthis.mService.length + 1]; 

java.lang.System.arraycopy((Object)mService, 0, 
(Object)newService, 0, this.mService.length); 

newService [newService. length - 1] = inp; 
mService = newService; 
25 } else if (index >= this.mService.length) { 

Service [] newService = new Servicefindex + 1]; 
java.lang.System.arraycopy((Object)mService, 0, 
(Object)newService, 0, this.mService.length); 

newServicepndex] = inp; 
30 mService = newService; 

} else { 

this.mServicefindex] — inp; 

} 

} 

3 5 public void setService(Service [] inp) { 

this.mService = inp; 

} 

} 

40 In addition to the JAVA beans set forth above, transformation code is 

produced for translating from JAVA to XML and XML to JAVA as set forth 
below: 

Java to XML 

45 <!DOCTYPE tree SYSTEM "tree.dtd"> 

<tree source = "null" pass-through = "false"> 
<before> 
<vardef name = "attribute.def '> 
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<element source = "ATTRIBUTE" class - "NAME" type = "5" position = "-2"> 
<parse> 

<data class = "java.lang.String" position = M -2"/> 
</parse> 
</element> 
</varde£> 

<vardef name = "pcdata.def '> 
<element source = "PCDATA" class = "NAME" type = "4" position = "-2"> 
<parse> 

<data class = "999" type = "6" position = "-27> 
</parse> 
</element> 
</varde£> 

<vardef name = "contentdef f > 
<element source - "PCDATA"> 
<parse> 

<data class = "999" type = "6" position = "-27> 
</parse> 
</element> 
</vardef> 

<vardef name = "ServiceSetvar u > 

<element source — "com.veo.xdk.dev. schema. test.blib.ServiceSet" class = "service. set" type 
"4" position = "-2"> 
<parse> 

<callvar name = " Service. var7> 
</parse> 
</element> 
</vardef> 

<vardef name = "PrototypeService.var"> 

<element source = "com. veo.xdk. dev. schema. test. blib.PrototypeService" class = 
"prototype.service" type = "4" position = "-2"> 
<parse> 

<callvar name = "pcdata.def parms — "setSource ServiceNameToXML setGenerator 
service.name"/> 

<callvar name = "pcdata.def parms = "setSource ServiceTermsToXML setGenerator 
service.terms7> 

<callvar name = "pcdata.def parms = "setSource ServiceLocationToXML setGenerator 
service .location' V> 

<callvar name = "ServiceOperation.var"/> 
</parse> 
</element> 
</vardef> 

<vardef name = ,T Service.var"> 

<element source = "com.veo.xdk.dev. schema. test.blib. Service" class = "service" type = "8" 
position = "0"> 
<parse> 

<callvar name = "pcdata.def parms = "setSource ServiceNameToXML setGenerator 
service. name"/> 

<callvar name = "pcdata.def parms = "setSource ServiceLocationToXML setGenerator 
service.location"/> 
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<callvar name = "ServiceOperation.var7> 

<callvar name = "pcdata.def parms = "setSource ServiceTermsToXML setGenerator 
service. terms"/> 
</parse> 
5 </element> 
</vardef> 

<vardef name = "ServiceOperation.var T, > 

<element source — "com.veo.xdk.dev.schema.test.blib.ServiceOperation" class = 
"service.operation" type = "4" position = "-2"> 
1 0 <parse> 

<callvar name = "pcdata.def 1 parms = "setSource ServiceOperationNameToXML 
setGenerator service.operation.name7> 

<callvar name = "pcdata.def parms = "setSource ServiceOperationLocationToXML 
setGenerator service. operation.location"/> 
1 5 <callvar name = "pcdata.def parms = "setSource ServiceOperationlnputToXML 

setGenerator service. operation.input7> 

<callvar name = "pcdata.def parms = "setSource ServiceOperationOutputToXML 
setGenerator service.operation.output"/> 
</parse> 
20 </element> 
</varde€> 
</before> 
<parse> 

<callvar name = "ServiceSet.var"/> 
25 <callvar name = "PrototypeService.var"/> 

<callvar name = "Service.var'V> 
<callvar name = "ServiceOperation.var7> 
</parse> 
</tree> 



30 



XML to Java 



<!DOCTYPE tree SYSTEM "tree.dtd"> 
<tree source = "null" pass-through = "false"> 
35 <before> 

<vardef name = "business.var"> 
<element source = "business" 

class = "com. veo.xdk.dev.schema.test.blib. Business" 
type = "7" setter = "setBusiness"> 
40 <before> 

<onattribute name = "business. number"> 
<actions> 

<callmeth name = "busmessNumberFromXML"> 
<parms> 

45 <getattr name = "business.number"/> 

</parms> 
</callmeth> 
</actions> 
</onattribute> 
50 </before> 
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<parse> 

<callvar name = "party. name. var" parms = "setPosition -17> 
<callvar name = ,f address.setvar7> 
</parse> 
5 </element> 
</vardef> 

<vardef name - "party .name. var "> 
<element source = "party .name" setter = "partyNameFromXML" position = "-1" class = 
"java.lang.String"> 
1 0 <parse> 

<data class = "java.lang. String" position = "07> 
</parse> 
</element> 
</vardef> 

1 5 <vardef name = "city.var"> 

<element source = "city" setter = "cityFromXML" position = "-1" class = "java.lang. String "> 
<parse> 

<data class = "java.lang. String" position = "0"/> 
</parse> 
20 </element> 
</vardef> 

<vardef name = "internet var"> 

<element source = "internet" setter = "internetFrornXML" position = "-1" class = 
"j ava. lang . String"> 
25 <parse> 

<data class = "java.lang.String" position = "07> 
</parse> 
</element> 
</vardef> 

3 0 <vardef name = "country .var"> 

<element source = "country" setter = "countryFromXML" position = "-1" class = 
"java.lang.String"> 
<parse> 

<data class = "java.lang.String" position = "0"/> 
35 </parse> 
</element> 
</vardef> 

<vardef name = "state .var"> 
<element source = "state" setter = "stateFromXML" position = class = "java.lang. String"> 
40 <parse> 

<data class = "java.lang.String" position = "0"/> 
</parse> 
</element> 
</vardef> 

45 <vardef name = "emaiLvar"> 

<element source = "email" setter = "emailFrornXML" position = "-1" class = 
"java.lang. String"> 
<parse> 

<data class = "java.lang.String" position = "07> 
50 </parse> 
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</element> 
</vardef> 

<vardef name = "address, physical. var"> 
<element source = "address.physical" 
5 class = M com.veo.xdk.dev.schema.test.blib.AddressPliysicar' 

type = "7" setter = "setAddressPhysicar> 
<before> 
</before> 
<parse> 

1 0 <callvar name = "street, var" parms = "setPosition -1 "/> 

<callvar name = "city.var" parms = "setPosition -l"/> 
<callvar name = "state, var" parms = "setPosition -17> 
<callvar name = "postcode, var" parms = "setPosition -17> 
<callvar name = "country. var" parms = "setPosition -l"/> 
1 5 </parse> 
</element> 
</varde£> 

<vardef name = "telephone. var"> 
<element source = "telephone" setter = "telephoneFromXML" position = "-1" class = 
20 "java.lang.String"> 
<parse> 

<data class = "java.lang. String" position = "0"/> 
</parse> 
</element> 
25 </vardef> 

<vardef name = "person. var"> 
<element source = "person" 

class = "com. veo.xdk.dev.schema.test.blib. Person" 
type = "7" setter = "setPerson"> 
30 <before> 

<onattribute name = "SSN"> 
<actions> 
<callmeth name = "sSNFromXML"> 
<parms> 

3 5 <getattr name = "SSN ,f /> 

</parms> 
</callmem> 
</actions> 
</onattribute> 
40 </before> 
<parse> 

<callvar name = "party .name. var" parms = "setPosition -17> 
<callvar name = "address.set.var"/> 
</parse> 
45 </element> 
</vardef> 

<vardef name = "fax. var "> 
<element source = "fax" setter = "faxFromXML" position = "-1" class = "java.lang. String"> 
<parse> 

50 <data class = "java.lang.String" position = "07> 
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</paise> 
</element> 
</vardef> 

<vardef name = "street. var"> 
5 <element source = "street" setter = "streetFromXML" position = "-1" class = 

"java.lang.String"> 
<parse> 

<data class = "java.lang. String" position = "07> 
</parse> 
10 </element> 
</vardef> 

<vardef name = "address, set. var"> 
<element source = "address.set" 

class = "com. veo.xdk. dev. schema. testblib.AddressSet" 
1 5 type = "7" setter = n setAddressSet"> 

<before> 
</before> 
<parse> 

<callvar name = ,T address.physical.var7> 
20 <callvar name = "telephone.var" parms = "setPosition -1 "/> 

<callvar name = "fax. var" parms = "setPosition -17> 
<callvar name = "email. var" parms = "setPosition -l"/> 
<callvar name = "internet, var" parms = "setPosition -17> 
</parse> 
25 </element> 
</vardef> 

<vardef name = "postcode.var"> 
<element source = "postcode" setter = "postcodeFromXML" position = "-1" class 
n java.lang.String"> 
30 <parse> 

<data class = "java.lang. String" position = "07> 
</parse> 
</element> 
</vardef> 

3 5 <vardef name = "market.participant. var "> 

<element source = "market participant" 

class = "com. veo.xdk.dev. schema. test.blibMarketParticipant" 
type = "7" position = "0"> 
<before> 
40 </before> 
<parse> 

<callvar name = "business.var"/> 
<callvar name = "person. var"/> 
</parse> 
45 </element> 
</vardef> 
</before> 
<parse> 

<callvar name = "business.var"/> 
50 <callvar name = "party .name.var n /> 
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10 



15 



<callvar name : 
<callvar name : 
<callvar name : 
<callvar name : 
<callvar name : 
<callvar name : 
<callvar name : 
<callvar name : 
<callvar name : 
<callvar name : 
<callvar name : 
<callvar name : 
<callvar name : 
</parse> 
</tree> 



■■ M city.var7> 

: "internet. var'7> 

: "country .var"/> 

: " state. var"/> 

: "email. var7> 

: "address. physical. var'V> 

= "telephone.var7> 

: "person. var"/> 

= "fax.var7> 

= "street. var"/> 

= "address.set.var"/> 

= "postcode.var7> 

= "market.participant.var"/> 



Makefiles: 

# 

20 # this makefile was generated by bic version 0.0. 05/02/1998 

# 
# 
# 
# 



25 



# get the package name from the package argument passed to SchemaGen 
PACKAGE NAME = com/veo/xdk/dev/schema/test/blib 



JAVA_SOURCES += \ 
3 0 MarketParticipantjava \ 

Businessjava\ 

Personjava \ 

Party .Java \ 

AddressPhysical.java V 
35 AddressSetjava \ 

MAKEFILEMASTERDIR " xxx 

include $(MAKEF1I.E_MASTER_DIR)/Makefile.rnaster 

40 all:: $(JAVA__CLASSES) 

# 

# this makefile was generated by bic version 0.0. 05/02/1998 

# 

45 # 

# 
# 

# get the package name from the package argument passed to SchemaGen 

-86- 



Atty Docket No.: 19957-701 
H:\PRIVATE\CLIENT\19957CN0WEOAPP.001 



PACKAGENAME = com/veo/xdk/dev/schema/test/blib 

JAVA__SOURCES += \ 
ServiceSetjava\ 
5 PrototypeService.java \ 

Service Java \ 
ServiceOperation.java \ 

MAKEFILE JV1ASTER_DIR = xxx 
1 0 include $(MAKEFILE_MASTER_DIR)/Makefile.master 

all:: $(JAVA_CLASSES) 

Finally, the XML document instances generated at run time according to 
1 5 the model above for one example follows: 



<!DOCTYPE market.participant SYSTEM "market.participant.dtd" > 
<market.participant> 

20 <business business .number=" 12345 67890" > 

<party.name>IBM</party.name> 

<address.set> 
25 <address.physical> 

<street>l IBM Way</street> 
<city>Palo Alto</city> 
<state>CA</state> 
30 <postcode>94304</postcode> 
<coxuitry>USA</country> 
</address.physical> 

<telephone>123 456-7890</telephone> 
35 <fax>123 456 0987</fax> 

<email>ibmec@ibm.com</email> 
</address.set> 



40 



</business> 
</marketparticipant> 



<!DOCTYPE service SYSTEM "service.dtd" > 
<service.set> 
45 <service> 

<service.name>Order Service</service.name> 

<service Jocation>www.ibm.com/order</service. location> 
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<service.operation> 

<service.operation.name>SubmitOrder</service.operation.name> 
<service.operation.location>www.^^ 

<service . operation.input>urn:x-ibm: services: order: operations :po . dtd</service.operation.input> 
5 <service.operation.output>urn:x- 

ibm:services:order:operations:poack.dtd</service.operation.output> 
</service.operation> 

<service.operation> 
1 0 <service.operation.name>Track Order</service.operation.name> 

<service.operation.location>www. ibm.com/ order/track</ service .location> 
<service . operation.input>urn:x- 

ibm:services:order:operations:track.irequest.dtd</service.operation.input> 
<service. operation.output>urn:x- 
1 5 ibm: services :order: operations:track.iresponse.dtd</ service.operation.output> 

</ service . operation> 

</service> 
</service.set> 

20 

Using the tools along with a BID composer application, which provides 
a drag, drop and forms editing user interface, a developer is able to create a 
business interface definition and to produce a well formed, valid business 
interface definition in the form of an XML document. Thus, the example run 

25 time instance is a business interface definition for an ordering service for IBM 

to be used by Ingram Micro and others to order laptop computers from IBM. 
(There is no relationship between the applicant and IBM or Ingram Micro). 
Utilizing these processes, a user is able to build a system that allows for 
programming of a business interface using the documents defined according to 

30 the present invention. 

The role of CBL and the BID processor of the present invention in an 
XML/JAVA environment can be further understood by the following 
explanation of the processing of a Purchase Order. 

Company A defines its Purchase Order document type using a visual 

35 programming environment that contains a library of CBL DTDs and modules, 

all defined using common business language elements so that they contain data 
type and other interpretation information. Company As PO might just involve 
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minor customizations to a more generic "transaction document" specification 
that comes with the CBL library, or it might be built from the ground up from 
CBL modules for address, date and time, currency, etc. 

The documentation for the generic "transaction document" specification 
5 (such as the transact.dtd set out above) typifies the manner in which CBL 

specifications are built from modules and are interlinked with other CBL DTDs. 

A compiler takes the purchase order definition and generates several 
different target forms. All of these target forms can be derived through "tree to 
tree" transformations of the original specification. The most important for this 
10 example are: 

(a) the XML DTD for the purchase order. 

(b) a JAVA Bean that encapsulates the data structures for a purchase 
order (the JAVA classes, arguments, datatypes, methods, and 

15 exception structures are created that correspond to information in 

the Schema definition of the purchase order). 

(c) A "marshaling" program that converts purchase orders that 
conform to the Purchase Order DTD into a Purchase Order 

20 JAVA Bean or loads them into a database, or creates HTML (or 

an XSL style sheet) for displaying purchase orders in a browser. 

(d) An "unmarshaling" program that extracts the data values from 
Purchase Order JAVA Beans and converts them into an XML 

25 document that conforms to the Purchase Order DTD. 

Now, back to the scenario. A purchasing application generates a 
Purchase Order that conforms to the DTD specified as the service interface for a 
supplier who accepts purchase orders. 
30 The parser uses the purchase order DTD to decompose the purchase 

order instance into a stream of information about the elements and attribute 
values it contains. These "property sets" are then transformed into 
corresponding JAVA event objects by wrapping them with JAVA code. This 
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transformation in effect treats the pieces of marked-up XML document as 
instructions in a custom programming language whose grammar is defined by 
the DTD. These JAVA events can now be processed by the marshaling 
applications generated by the compiler to "load" JAVA Bean data structures. 

Turning the XML document into a set of events for JAVA applications 
to process, is unlike the normal model of parsing in which the parser output is 
maintained as an internal data structure and processing does not begin until 
parsing completes. The event based processing, in response to the BID 
definitions, is the key to enabling the much richer functionality of the processor 
because it allows concurrent document application processing to begin as soon 
as the first event is emitted. 

JAVA programs that "listen for" events of various types are generated 
from the Schema definition of those events. These listeners are programs 
created to carry out the business logic associated with the XML definitions in 
the CBL; for example, associated with an "address" element may be code that 
validates the postal code by checking a database. These listeners "subscribe" to 
events by registering with the document router, which directs the relevant 
events to all the subscribers who are interested in them. 

This publish and subscribe architecture means that new listener 
programs can be added without knowledge by or impact on existing ones. Each 
listener has a queue into which the router directs its events, which enables 
multiple listeners can handle events in parallel at their own pace. 

For the example purchase order here, there might be listeners for: 

• the purchase order, which would connect it to an order entry 
program, 

• product descriptions, which might check inventory, 

• address information, which could check Fed Ex or other service 
for delivery availability, 
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• buyer information, which could check order history (for 

creditworthiness, or to offer a promotion, or similar processing 
based on knowing who the customer is). 
Complex listeners can be created as configurations of primitive ones 
5 (e.g., a purchase order listener may contain and invoke these listeners here, or 

they may be invoked on their own). 

Fig. 1 1 illustrates the market maker node in the network of Fig. 1 . The 
market maker node includes the basic structures of the system of Fig. 3, 
including a network interface 1 101, a document parser 1 102, a document to host 
10 and host to document translator 1 103, and a front end 1 104, referred to as a 

router in this example. The market maker module 1 1 05 in this example 
includes a set of business interface definitions, or other identifiers sufficient to 
support the market maker function, for participants in the market, a CBL 
repository, and a compiler all serving the participants in the market. The router 
15 1 104 includes a participant registry and document filters which respond to the 

events generated at the output of the translator and by the parser to route 
incoming documents according to the participant registry and according to the 
element and attribute filters amongst the listeners to the XML event generators. 
Thus, certain participants in the market may register to receive documents that 
20 meet prespecified parameters. For example, input documents according to a 

particular DTD, and including an attribute such as numbers of products to be 
purchased greater than a threshold, or such as a maximum price of a document 
request to be purchased, can be used to filter documents at the router 1 104. 
Only such documents as match the information registered in the participant 
25 registry at the router 1 104 are then passed on to the registered participant. 

The router 1 104 may also serve local host services 1 105 and 1 106, and 
as such act as a participant in the market as well as the market maker. 
Typically, documents that are received by the router 1 104 are traversed to 
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determine the destinations to which such documents should be routed, there 
again passed back through the translator 1 103, if necessary, and out the network 
interface 1 101 to the respective destinations. 

The market maker is a server that binds together a set of internal and 
5 external business services to create a virtual enterprise or trading community. 

The server parses incoming documents and invokes the appropriate services by, 
for example, handing off a request for product data to a catalog server or 
forwarding a purchase order to an ERP system. The server also handles 
translation tasks, mapping the information from a company's XML documents 

10 onto document formats used by trading partners and into data formats required 

by its legacy systems. 

With respect to the service definition above, when a company submits a 
purchase order, the XML parser in the server uses the purchase order DTD to 
transform the purchase order instance into a stream of information events. These 

1 5 events are then routed to any application that is programmed to handle events of 

a given type; in some cases, the information is forwarded over the Internet to a 
different business entirely. In the purchase order example, several applications 
may act on information coming from the parser: 

• An order entry program processes the purchase order as a 
20 complete message; 

• An ERP system checks inventory for the products described in 
the purchase order; 

• A customer database verifies or updates the customer's address; 

• A shipping company uses the address information to schedule a 
25 delivery 

• A bank uses the credit card information to authorize the 
transaction. 
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Trading partners need only agree on the structure, content, and 
sequencing of the business documents they exchange, not on the details of APIs. 
How a document is processed and what actions result is strictly up to the 
business providing the service. This elevates integration from the system level 
5 to the business level. It enables a business to present a clean and stable interface 

to its business partners despite changes in its internal technology 
implementation, organization, or processes. 

Figs. 12, 13 and 14 illustrate processes executed at a market maker node 
in the system of Fig. 1 1. In Fig. 12, an input document is received at the 

10 network interface from an originating participant node (step 1200). The 

document is parsed (step 1201). The document is translated to the format of the 
host, for example XML to JAVA (step 1202). The host formatted events and 
objects are then passed to the router service (step 1203). The services registered 
to accept the document according to the document type and content of the 

15 document are identified (step 1204). The document or a portion of the 

document is passed to the identified services (step 1205). As service is 
performed in response to the document content (step 1206). The output data of 
the service is produced (step 1207). The output is converted to the document 
format, for example from a JAVA format to an XML format (step 1208). 

20 Finally, the output document is sent to a participant node (step 1209). 

The registration service is one such function which is managed by the 
router. Thus, a market participant document is accepted at the network interface 
as shown in Fig. 13 (step 1300). The market participant document is stored in 
the business interface definition repository (step 1301) for the market maker 

25 node. In addition, the document is parsed (step 1302). The parsed document is 

translated into the format of the host (step 1303). Next, the document is passed 
to the router service (step 1304). The router service includes a listener which 
identifies the registration service as the destination of the document according to 
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the document type and content (step 1305). The document or elements of the 
document are passed to the registration service (step 1306). In the registration 
service, the needed service specifications are retrieved according to the business 
interface definition (step 1307). If the service specifications are gathered, at 
5 step 1308, the router service filters are set according to the business interface 

definition and the service specifications (step 1309). Registration 
acknowledgment data is produced (1 3 10). The registration acknowledgment 
data is converted to a document format (step 1311). Finally, the 
acknowledgment document is sent to the participant node indicating to the 

10 participant that is successfully registered with the market maker (step 1312). 

The process at step 1307 of gathering needed service specifications is 
illustrated for one example in Fig. 14. This process begins by locating a service 
business interface definition supported by the market participant (step 1400). 
The service definition is retrieved, for example by an E-mail transaction or web 

15 access to repository node (step 1401). The service specification is stored in the 

BID repository (step 1402). The service business interface definition document 
is parsed (step 1403). The parsed document is translated into the format of the 
host (step 1404). Host objects are passed to the router service (step 1405). The 
registration service is identified according to the document type and content 

20 (step 1406). Finally, the information in the service business interface definition 

document is passed to the registration service (step 1407) for use according to 
the process of Fig. 13. 

Fig. 15 illustrates the processor, components and sequence of processing 
of incoming data at market maker node according to the present invention. The 

25 market maker node includes a communication agent 1500 at the network 

interface. The communication agent is coupled with an XML parser 1501 
which supplies events to an XML processor 1502. The XML processor supplies 
events to a document router. The document router feeds a document service 
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1504 that provides an interface for supplying the received documents to the 
enterprise solution software 1505 in the host system. The communication agent 
1500 is an Internet interface which includes appropriate protocol stacks 
supporting such protocols as HTTP, SMTP, FTP, or other protocols. Thus, the 
5 incoming data could come in an XML syntax, an ASCII data syntax or other 

syntax as suits a particular communication channel. All the documents received 
in non-XML syntaxes are translated into XML and passed the XML parser. A 
translation table 1506 is used to support the translation from non-XML form 
into XML form. 

10 The converted documents are supplied to the parser 1501 . The XML 

parser parses the received XML document according to the document type 
definition which matches it. If an error is found, then the parser sends the 
document back to the communication agent 1500. A business interface 
definition compiler BIDC 1507 acts as a compiler for business interface 

15 definition data. The DTD file for the XML parser, JAVA beans corresponding 

to the DTD file, and translation rules for translating DTD files to JAVA beans 
are created by compiling the BID data. An XML instance is translated to JAVA 
instance by referring to these tools. Thus the BID compiler 1507 stores the 
DTD documents 1508 and produces JAVA documents which correspond 1509. 

20 The XML documents are passed to the processor 1502 which translates them 

into the JAVA format. In a preferred system, JAVA documents which have the 
same status as the document type definitions received in the XML format are 
produced. The JAVA beans are passed to the document router 1503. The 
document router 1503 receives the JAVA beans and passes the received class to 

25 the appropriate document service using a registry program, for example using 

the event listener architecture described above. The document service 1504 
which receives the document in the form of JAVA beans from the router 1503 
acts as the interface to the enterprise solution software. This includes a registry 

-95- 



Atty Docket No.: 19957-701 
H:\PRIVATE\CLIENT\19957CN0WEOAPP.001 



service 1510 by which listeners to XML events are coupled with the incoming 
data streams, and a service manager 151 1 to manage the routing of the incoming 
documents to the appropriate services. The document service manager 1511 
provides for administration of the registry service and for maintaining document 
consistency and the like. 

The document service communicates with the back end system using 
any proprietary API, or using such more common forms as the CORB A/COM 
interface or other architectures. 

Fig. 16 provides a heuristic diagram of the market maker and market 
participant structures according to the present invention. Thus, the electronic 
commerce market according to the present invention can be logically organized 
as set forth in Fig. 16. At the top of the organization, a market maker node 1600 
is established. The market maker node includes resources that establish a 
marketplace 1601 . Such resources include a market registry service and the 
like. Businesses 1602 register in the marketplace 1601 by publishing a business 
interface definition. The business interface definition defines the services 1603 
for commercial transactions in which the businesses will participate. The 
transactions 1604 and services 1603 use documents 1605 to define the inputs 
and outputs, and outline the commercial relationship between participants in the 
transaction. The documents have content 1606 which carries the particulars of 
each transaction. The manner in which the content is processed by the 
participants in the market, and by the market maker is completely independent 
of the document based electronic commerce network which is established 
according to the present invention. Overall, a robust, scalable, intuitive 
structure is presented for enabling electronic commerce on communication 
networks is provided. 

Thus, the present invention in an exemplary system provides a platform 
based on the XML processor and uses XML documents as the interface between 
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loosely coupled business systems. The documents are transferred between 
businesses and processed by participant nodes before entering the company 
business system. Thus the platform enables electronic commerce applications 
between businesses where each business system operates using different internal 
commerce platforms, processes and semantics, by specifying a common set of 
business documents and forms. 

According to the present invention, virtual enterprises are created by 
interconnecting business systems and service, are primarily defined in terms of 
the documents (XML-encoded) that businesses accept and generate: 

• "if you send me a request for a catalog, I will send you a catalog: 

• "if you send me a purchase order and I can accept it, I will send 
you an invoice". 

The foregoing description of a preferred embodiment of the invention 
has been presented for purposes of illustration and description. It is not 
intended to be exhaustive or to limit the invention to the precise forms 
disclosed. Obviously, many modifications and variations will be apparent to 
practitioners skilled in this art. It is intended that the scope of the invention be 
defined by the following claims and their equivalents. 

What is claimed is: 
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CLAIMS 



1 1 . An interface for transactions among nodes in a network 

2 including a plurality of nodes which execute processes involved in the 

3 transactions, comprising: 

4 a machine readable specification of an interface to transaction processes 

5 stored in memory accessible by at least one node in the network, including 

6 interpretation information providing a definition of an input document, and a 

7 definition of an output document, the definitions of the input and output 

8 documents comprising respective descriptions of sets of storage units and 

9 logical structures for the sets of storage units. 

1 2. The interface of claim 1, wherein the interpretation information 

2 includes data type specifications for at least one logical structure in the 

3 definitions of the input and output documents. 

1 3. The interface of claim 1, wherein the interpretation information 

2 includes at least one data structure mapping predefined sets of storage units for 

3 a particular logical structure in the definitions of the input and output 

4 documents, to respective entries in a list. 

1 4. The interface of claim 1, including a repository in memory 

2 accessible by at least one node in the network storing a library of logical 

3 structures, and interpretation information for logic structures. 

1 5 . The interface of claim 1 , wherein the machine readable 

2 specification includes a document compliant with a definition of an interface 

3 document including logical structures for storing an identifier of a particular 



-98- 

Atty Docket No.: 19957-701 

H:\PRIVATE\CLIENT\19957CN0WEOAPP.001 



4 transaction, and at least one of definitions and references to definitions of input 

5 and output documents for the particular transaction. 

1 6. The interface of claim 1 , wherein the machine readable 

2 specification includes a document compliant with a definition of an interface 

3 document including logical structures for storing an identifier of the interface, 

4 and for storing at least one of specifications and references to specifications of a 

5 set of one or more transactions supported by the interface. 

1 7. The interface of claim 6 ? wherein the machine readable 

2 specification includes a reference to a specification of a particular transaction, 

3 and the specification of the particular transaction includes a document including 

4 logical structures for storing at least one of definitions and references to 

5 definitions of input and output documents for the particular transaction. 

1 8. The interface of claim 1, wherein the storage units comprise 

2 parsed data. 

1 9. The interface of claim 8, wherein the parsed data in at least one 

2 of the input and output documents comprises: 

3 character data encoding text characters in the one of the input and output 

4 documents, and 

5 markup data identifying sets of storage units according to the logical 

6 structure of the one of the input and output documents. 

1 10. The interface of claim 9, wherein at least one of the sets of 

2 storage units encodes a plurality of text characters providing a natural language 

3 word. 
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1 11. The interface of claim 8, wherein the interpretation information 

2 for at least one of the sets of storage units identified by a particular logical 

3 structure of at least one of the input and output documents, encodes respective 

4 definitions for sets of parsed characters. 

1 12. The interface of claim 8, wherein the storage units comprise 

2 unparsed data. 

1 13. The interface of claim 1 , including a repository stored in memory 

2 accessible by at least one node in the network of document types for use in a 

3 plurality of transactions, and wherein the definition of one of the input and 

4 output documents includes a reference to a document type in the repository. 

1 14. The method of claim 13, wherein the repository of document 

2 types includes a document type for identifying participant processes in the 

3 network. 

1 15. The interface of claim 1, wherein the definitions of the input and 

2 output documents comprise document type definitions compliant with a 

3 standard Extensible Markup Language XML. 

1 16. The interface of claim 1 , wherein the machine readable data 

2 structure including interpretation information comprises a document organized 

3 according to a document type definition compliant with a standard Extensible 

4 Markup Language XML. 
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1 17. Apparatus for establishing participant interfaces for transactions 

2 executed on a system including a network interface and a data processing 

3 resources which execute a transaction processes of the transactions according to 

4 a transaction processing architecture; comprising: 

5 programs of instructions executable by the system, stored on a medium 

6 accessible by the system, providing tools to build a definition of a participant 

7 interface for a participant in a particular transaction, the definition of a 

8 participant interface including a definition of an input document for the 

9 participant and a definition of an output document for the participant, the 

10 definitions of the input and output documents comprising respective machine- 

1 1 readable descriptions of sets of storage units and logical structures for the sets of 

12 storage units; and 

13 programs of instructions executable by the system, stored on a medium 

14 accessible by the system and responsive to the definitions of the input and 

15 output documents, to compile data structures corresponding to the sets of 

16 storage units and logical structures of the input and output documents 

1 7 compliant with the transaction processing architecture, to compile instructions 

1 8 executable by the system to translate the input document to the corresponding 

19 data structures, and to compile instructions executable by the system to translate 

20 output of the transaction processes into the sets of storage units and logical 

21 structures of the output document. 

1 18. The apparatus of claim 17, wherein the tools to build a 

2 definition of a participant interface include instructions executable by the 

3 system to access elements of the definition from a repository, the repository 

4 storing a library of logical structures, and interpretation information for logic 

5 structures used to build interface descriptions. 
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1 19. The apparatus of claim 1 8, wherein the repository stores 

2 definitions of documents comprising logic structures. 

1 20. The apparatus of claim 17, wherein the tools to build a 

2 definition of a participant interface include instructions executable by the 

3 system 

4 to access a definition of another participant interface for a 

5 complementary transaction, the accessed definition including a definition of an 

6 input document for the complementary transaction, and a definition of an output 

7 document for the complementary transaction; and 

8 to establish the definition of the participant interface by including the 

9 definition of the output document of the complementary transaction as the 
1 0 definition of the input document of the interface being built. 

1 21 . The apparatus of claim 20, wherein the tools to build a 

2 definition of a participant interface include instructions executable by the 

3 system 

4 to include the definition of the input document of the complementary 

5 transaction as the definition of the output document of interface being built. 

1 22. The apparatus of claim 17, wherein the tools to build a 

2 definition of a participant interface include instructions executable by the 

3 system to build a document compliant with a definition of a participant interface 

4 document including logical structures for storing an identifier of a particular 

5 transaction, and at least one of definitions and references to definitions of input 

6 and output documents for the particular transaction. 
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1 23. The apparatus of claim 17, wherein the tools to build a 

2 definition of a participant interface include instructions executable by the 

3 system to build a document compliant with a definition of a participant interface 

4 document including logical structures for storing an identifier of the participant 

5 interface, and for storing at least one of specifications and references to 

6 specifications of a set of one or more transactions supported by the participant 

7 interface. 

1 24. The apparatus of claim 23 , wherein the a document compliant 

2 with a definition of a participant interface document includes a reference to a 

3 machine-readable specification of a particular transaction, and the specification 

4 of the particular transaction includes a document including logical structures for 

5 storing at least one of definitions and references to definitions of input and 

6 output documents for the particular transaction. 

1 25 . The apparatus of claim 1 7, wherein the storage units comprise 

2 parsed data. 

1 26. The apparatus of claim 25 , wherein the parsed data in at least one 

2 of the input and output documents comprises: 

3 character data encoding text characters in the one of the input and output 

4 documents, and 

5 markup data identifying sets of storage units according to the logical 

6 structure of the one of the input and output documents. 

1 27. The apparatus of claim 26, wherein at least one of the sets of 

2 storage units encodes a plurality of text characters providing a natural language 

3 word. 
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1 28. The apparatus of claim 25 , wherein the specification includes 

2 interpretation information for at least one of the sets of storage units identified 

3 by the logical structure of at least one of the input and output documents, 

4 encoding respective definitions for sets of parsed characters. 

1 29. The apparatus of claim 25, wherein the storage units comprise 

2 unparsed data. 

1 30. The apparatus of claim 17, wherein data structures corresponding 

2 to the sets of storage units and logical structures of the input and output 

3 documents include programming objects including variables and methods 

4 according to the variant transaction processing architecture. 

1 31. The apparatus of claim 17, wherein the variant transaction 

2 processing architectures of the transaction process includes comprises a process 

3 compliant with an interface description language. 

1 32. The apparatus of claim 17, wherein the definitions of the input 

2 and output documents comprise document type definitions compliant with a 

3 standard Extensible Markup Language XML. 

1 33. The apparatus of claim 1 9, wherein the definition of one of the 

2 input and output documents includes a reference to a document type in the 

3 repository. 
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34. The apparatus of claim 18, wherein the repository includes 
interpretation information specifying measurements of products subject of 
transactions. 



1 35. The apparatus of claim 18, wherein the repository includes 

2 interpretation information specifying costs of products subject of transactions. 

1 36. The apparatus of claim 18, wherein the repository includes 

2 interpretation information specifying features of products subject of 

3 transactions. 

1 37. The apparatus of claim 18, wherein the repository includes 

2 interpretation information specifying financial terms of transactions. 

1 38. The apparatus of claim 1 8, wherein the repository includes 

2 interpretation information specifying terms of shipment for products subject of 

3 transactions. 

1 39. Apparatus for establishing participant interfaces for transactions 

2 executed on a system; comprising: 

3 memory storing data and programs of instructions; 

4 a data processor coupled to the memory which executes the programs of 

5 instructions; wherein the programs of instructions include 

6 tools to build a definition of a participant interface for a participant in a 

7 particular transaction, the definition of a participant interface 

8 including a definition of an input document for the participant 

9 and a definition of an output document for the participant, the 
10 definitions of the input and output documents comprising 



-105- 

Atty Docket No.: 19957-701 
H:\PRIVATE\CLIENT\1 9957CN0WEOAPP.00 1 



1 1 respective machine-readable descriptions of sets of storage units 

12 and logical structures for the sets of storage units; and 

13 a compiler, responsive to the definitions of the input and output 

1 4 documents, to compile data structures corresponding to the sets 

15 of storage units and logical structures of the input and output 

1 6 documents compliant with the transaction processing 

1 7 architecture, to compile instructions executable by the system to 

1 8 translate the input document to the corresponding data structures, 

1 9 and to compile instructions executable by the system to translate 

20 output of the transaction processes into the sets of storage units 

21 and logical structures of the output document. 

1 40. The apparatus of claim 39, including a repository stored in 

2 memory accessible by the data processor, and wherein the tools to build a 

3 definition of a participant interface include instructions executable by the 

4 system to access elements of the definition from the repository, the repository 

5 storing a library of logical structures, and interpretation information for logic 

6 structures used to build interface descriptions. 

1 41 . The apparatus of claim 40, wherein the repository stores 

2 definitions of documents comprising logic structures. 

1 42. The apparatus of claim 39, wherein the tools to build a 

2 definition of a participant interface include instructions executable by the 

3 system 

4 to access a definition of another participant interface for a 

5 complementary transaction, the accessed definition including a definition of an 
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6 input document for the complementary transaction, and a definition of an output 

7 document for the complementary transaction; and 

8 to establish the definition of the participant interface by including the 

9 definition of the output document of the complementary transaction as the 
1 0 definition of the input document of the interface being built. 

1 43. The apparatus of claim 42, wherein the tools to build a 

2 definition of a participant interface include instructions executable by the 

3 system 

4 to include the definition of the input document of the complementary 

5 transaction as the definition of the output document of interface being built. 

1 44. The apparatus of claim 39, wherein the tools to build a 

2 definition of a participant interface include instructions executable by the 

3 system to build a document compliant with a definition of a participant interface 

4 document including logical structures for storing an identifier of a particular 

5 transaction, and at least one of definitions and references to definitions of input 

6 and output documents for the particular transaction. 

1 45. The apparatus of claim 39, wherein the tools to build a 

2 definition of a participant interface include instructions executable by the 

3 system to build a document compliant with a definition of a participant interface 

4 document including logical structures for storing an identifier of the participant 

5 interface, and for storing at least one of specifications and references to 

6 specifications of a set of one or more transactions supported by the participant 

7 interface. 
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1 46. The apparatus of claim 45, wherein the a document compliant 

2 with a definition of a participant interface document includes a reference to a 

3 machine-readable specification of a particular transaction, and the specification 

4 of the particular transaction includes a document including logical structures for 

5 storing at least one of definitions and references to definitions of input and 

6 output documents for the particular transaction. 

1 47. The apparatus of claim 39, wherein the storage units comprise 

2 parsed data. 

1 48. The apparatus of claim 47, wherein the parsed data in at least one 

2 of the input and output documents comprises: 

3 character data encoding text characters in the one of the input and output 

4 documents, and 

5 markup data identifying sets of storage units according to the logical 

6 structure of the one of the input and output documents. 

1 49. The apparatus of claim 48, wherein at least one of the sets of 

2 storage units encodes a plurality of text characters providing a natural language 

3 word. 

1 50. The apparatus of claim 47, wherein the specification includes 

2 interpretation information for at least one of the sets of storage units identified 

3 by the logical structure of at least one of the input and output documents, 

4 encoding respective definitions for sets of parsed characters. 

1 51. The apparatus of claim 47, wherein the storage units comprise 

2 unparsed data. 
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1 52. The apparatus of claim 39, wherein data structures corresponding 

2 to the sets of storage units and logical structures of the input and output 

3 documents include programming objects including variables and methods 

4 according to the variant transaction processing architecture. 

1 53. The apparatus of claim 39, wherein the variant transaction 

2 processing architectures of the transaction process comprises a process 

3 compliant with an interface description language. 

1 54. The apparatus of claim 39, wherein the definitions of the input 

2 and output documents comprise document type definitions compliant with a 

3 standard Extensible Markup Language XML. 

1 55. The apparatus of claim 4 1 , wherein the definition of one of the 

2 input and output documents includes a reference to a document type in the 

3 repository. 

1 56. The apparatus of claim 40, wherein the repository includes 

2 interpretation information specifying measurements of products subject of 

3 transactions. 

1 57. The apparatus of claim 40, wherein the repository includes 

2 interpretation information specifying costs of products subject of transactions. 

1 58. The apparatus of claim 40, wherein the repository includes 

2 interpretation information specifying features of products subject of 

3 transactions. 
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1 59. The apparatus of claim 40, wherein the repository includes 

2 interpretation information specifying financial terms of transactions. 

1 60. The apparatus of claim 40, wherein the repository includes 

2 interpretation information specifying terms of shipment for products subject of 

3 transactions. 

1 6 1 . A method for programming a commercial transaction in a 

2 network, comprising: 

3 defining a machine readable definition of an input document for a node 

4 in the network including resources to execute a process in the transaction, and a 

5 machine readable definition of an output document for the node, the definitions 

6 of the input and output documents comprising respective descriptions of sets of 

7 storage units and logical structures for the sets of storage units; and 

8 providing interpretation information for the logical structures to the 

9 node. 

1 62. The method of claim 6 1 , wherein the interpretation information 

2 includes data type specifications for at least one logical structure in the 

3 definitions of the input and output documents. 

1 63 . The method of claim 6 1 , wherein the interpretation information 

2 includes at least one data structure mapping predefined sets of storage units for 

3 a particular logical structure in the definitions of the input and output 

4 documents, to respective entries in a list. 
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1 64. The method of claim 61, the step of providing interpretation 

2 information includes providing a repository in memory accessible by at least 

3 one node in the network storing a library of logical structures, and interpretation 

4 information for logic structures. 

1 65 . The method of claim 6 1 9 including defining a machine readable 

2 specification of an interface including a document compliant with a definition of 

3 an interface document including logical structures for storing an identifier of a 

4 particular transaction, and at least one of the definitions and references to the 

5 definitions of the input and output document. 

1 66. The method of claim 6 1 , wherein the storage units comprise 

2 parsed data. 

1 67. The method of claim 66, wherein the parsed data in at least one 

2 of the input and output documents comprises: 

3 character data encoding text characters in the one of the input and output 

4 documents, and 

5 markup data identifying sets of storage units according to the logical 

6 structure of the one of the input and output documents. 

1 68. The method of claim 67, wherein at least one of the sets of 

2 storage units encodes a plurality of text characters providing a natural language 

3 word. 

1 69. The method of claim 67, wherein the interpretation information 

2 for at least one of the sets of storage units identified by a particular logical 
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3 structure of at least one of the input and output documents, encodes respective 

4 definitions for sets of parsed characters. 

1 70. The method of claim 66, wherein the storage units comprise 

2 unparsed data. 

1 71. The method of claim 6 1 , wherein the definitions of the input and 

2 output documents comprise document type definitions compliant with a 

3 standard Extensible Markup Language XML. 

1 72 . The method of claim 6 1 , including: 

2 providing a parser to generate event signals in response to logical 

3 structures in the definition of the input document; and 

4 providing event listener programs which respond to the event signals to 

5 execute the process. 
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DOCUMENTS FOR COMMERCE IN TRADING 
PARTNER NETWORKS AND INTERFACE DEFINITIONS BASED ON 



THE DOCUMENTS 



ABSTRACT 



Machine readable documents connect businesses with customers, 
suppliers and trading partners. The self defining electronic documents, such as 
XML based documents, can be easily understood amongst the partners. 
Definitions of these electronics business documents, called business interface 
definitions, are posted on the Internet, or otherwise communicated to members 
of the network. The business interface definitions tell potential trading partners 
the services the company offers and the documents to use when communicating 
with such services. Thus, a typical business interface definition allows a 
customer to place an order by submitting a purchase order or a supplier checks 
availability by downloading an inventory status report. Also, composition of the 
input and output documents, coupled with interpretation information in a 
common business library, programs the transaction in a way which closely 
parallels the way in which paper based businesses operate. 
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Attorney Docket No. 19957-701 

COMBINED DECLARATION AND POWER OF ATTORNEY 
FOR UTILITY PATENT APPLICATION 

As a below-named inventor, I hereby declare that: 

My residence, post office address and citizenship are as stated below next to my 

name; 

I believe I am the original, first and sole inventor (if only one name is listed below) or 
an original, first and joint inventor (if plural names are listed below) of the subject matter 
which is claimed and for which a patent is sought on the invention entitled: 

DOCUMENTS FOR COMMERCE IN TRADING PARTNER NETWORKS AND 
INTERFACE DEFINITIONS BASED ON THE DOCUMENTS 

the specification of which 

X is attached hereto. 



was filed on as Application No. 

and was amended on * . 

(If Applicable) 

I hereby state that I have reviewed and understand the contents of the above-identified 
specification, including the claims, as amended by any amendment referred to above. 

I acknowledge the duty to disclose information which is material to the examination 
of this application in accordance with Title 37, Code of Federal Regulations, § 1.56(a) which 
states in relevant part: "Each individual associated with the filing and prosecution of a patent 
application has a duty of candor and good faith in dealing with the Office, which includes a 
duty to disclose to the Office all information known to that individual to be material to 
patentability as defined in this section.... The duty to disclose all information known to be 
material to patentability is deemed to be satisfied if all information known to be material to 
patentability of any claim issued in a patent was cited by the Office or submitted to the Office 
in the manner prescribed by §§ 1.97(b)-(d) and 1.98." 

I hereby claim foreign priority benefits under Title 35, United States Code, §1 19 of 
any foreign application(s) for patent or inventor's certificate as indicated below and have also 
identified below any foreign application for patent or inventor's certificate on this invention 
having a filing date before that of the application on which priority is claimed: 
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Prior Foreign Application(s) 



Priority Claimed 



(Number) 



(Country) 



(Day/Month/Year Filed) Yes 



No 



(Number) 



(Country) 



(DayMonth/Year Filed) Yes 



No 



I hereby claim the benefit under Title 35, United States Code, §120 of any United 
States application(s), and under §1 19(e) of any United States provisional application(s), lifted 
below and, insofar as the subject matter of each of the claims of this application is not 
disclosed in the prior United States application in the manner provided by the first paragraph 
of Title 35, United States Code, §112, 1 acknowledge the duty to disclose material 
information as defined in Title 37, Code of Federal Regulation, §1. 56(a) which occurred 
between the filing date of the prior application and the national or PCT international filing 
date of this application: 



(Application Serial No.) (Filing Date) (Patented, Pending, Abandoned) 



(Application Serial No.) (Filing Date) (Patented, Pending, Abandoned) 

I hereby appoint the following attorney(s) and/or agent(s) to prosecute this application 
and transact all business in the Patent and Trademark Office connected therewith, and to file, 
prosecute and to transact all business in connection with international applications directed to 
said invention: 



Mark A. Haynes 
John J. Bruckner 
Charles C. Cary 



Paul Davis 



Michael J. Murphy 
David J. Weitz 
Kent R. Richardson 
David J. Abraham 
U.P. Peter Eng 
George A. Willman 
Henry J. Groth 
Steven J. Benerofe 



Travis L. Dodd 
Jinntung Su 



Hayward A. Verdun 
Van Mahamedi 



29,294 
30,846 
35,816 
36,764 
37,404 
38,362 
39,443 
39,554 
39,666 
41,378 
39,696 
41,613 
42,491 
42,174 
43,223 
42,828 
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Address all correspondence to: 



Mark A. Haynes 

Wilson Sonsini Goodrich & Rosati 
650 Page Mill Road 
Palo Alto, CA 94304 



Direct all telephone calls to Mark A. Havnes at (650) 493-9300. 

I hereby declare that all statements made herein of my own knowledge are true and that 
all statements made on information and belief are believed to be true; and further that these 
statements were made with the knowledge that willful false statements and the like so made 
are punishable by fine or imprisonment, or both, under Title 18, United States Code, §1001 
and that such willful false statements may jeopardize the validity of the application or any 
patent issued thereon. 



Full name of sole or 
first inventor: 

Inventor's signature: 

Date: 

Citizenship: 

Residence: 

Post Office Address: 



Bart Alan Meltzer 



United States 



530 Santa Marguarita. Aptos, California 95003 



Same as above. 



Full name of second joint 
inventor, if any : : Terrv Allen 

Inventor's signature: 

Date: 

Citizenship: United States 

Residence: SebastopoL California 95473 

Post Office Address: Same as above. 
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Full name of third joint 

inventor, if any:: 
Inventor's signature: 
Date: 

Citizenship: 

Residence: 

Post Office Address: 



Matthew Daniel Fuchs 



United States 



16229 Jacaranda Wav. Los Gatos. California 95032 



Same as above. 



Full name of fourth joint 

inventor, if any:: 
Inventor's signature: 
Date: 

Citizenship: 

Residence: 

Post Office Address: 



Robert John Glushko 



United States 



159 Mendosa Avenue. San Francisco. California 94116 
Same as above. 



Full name of fifth joint 

inventor, if any:: 
Inventor's signature: 
Date: 

Citizenship: 

Residence: 

Post Office Address: 



Murray Malonev 



Canada 



671 Cowan Circle, Pickering, Ontario. Canada. L1W 3K6 
Same as above. 
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